http://wiki.koha.org.ua/api.php?action=feedcontributions&user=Dubyk&feedformat=atomKoha Ukraine Wiki - Внесок користувача [uk]2024-03-19T08:07:08ZВнесок користувачаMediaWiki 1.31.2http://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9248Встановлення Koha з репозитарію на ОС Debian2024-01-30T07:38:35Z<p>Dubyk: /* Встановлення БД MySQL та допоміжних пакунків */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.11.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:<br />
<br />
Встановити gpg<br />
apt-get install gnupg2<br />
<br />
Звантажити та встановити ключ<br />
<br />
Новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або старіший спосіб<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).<br />
<br />
Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою<br />
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<br />
<br />
Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр<br />
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<br />
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<br />
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<br />
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<br />
'''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'''<br />
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<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Щодо phpmyadmin також див. https://think.unblog.ch/en/phpmyadmin-error-php-7-2-5-is-required/<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 12.2023 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
<br />
* '''Locale::XGettext::TT2'''<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
<br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці<br />
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA<br />
разом з раніше скопійованими '''SQL'''-файлами.<br />
<br />
Також можете встановити деякі інші мови інтерфейсу<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „ukr_unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль та логін можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).<br />
<br />
¹Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
== Вимкнення оновлення Koha ==<br />
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list <br />
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main<br />
<br />
Це дозволить легко оновлювати інші пакунки Debian<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
Вилучення налаштувань для веб-сервера Apache2<br />
<br />
rm /etc/apache2/sites-enabled/ukr_unimarc.conf<br />
rm /etc/apache2/sites-available/ukr_unimarc.conf<br />
<br />
Якщо після видалення планується перевстановлення Коха, то ще потрібно <br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9247Встановлення Koha з репозитарію на ОС Debian2024-01-16T22:19:53Z<p>Dubyk: /* E-mail */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.11.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:<br />
<br />
Встановити gpg<br />
apt-get install gnupg2<br />
<br />
Звантажити та встановити ключ<br />
<br />
Новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або старіший спосіб<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).<br />
<br />
Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою<br />
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<br />
<br />
Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр<br />
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<br />
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<br />
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<br />
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<br />
'''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'''<br />
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<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 12.2023 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
<br />
* '''Locale::XGettext::TT2'''<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
<br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці<br />
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA<br />
разом з раніше скопійованими '''SQL'''-файлами.<br />
<br />
Також можете встановити деякі інші мови інтерфейсу<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „ukr_unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль та логін можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).<br />
<br />
¹Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
== Вимкнення оновлення Koha ==<br />
Для більш контрольованого оновлення пакунків Коха можна тимчасово виключити оновлення у /etc/apt/sources.list.d/koha.list <br />
#deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] http://debian.koha-community.org/koha 23.05 main<br />
<br />
Це дозволить легко оновлювати інші пакунки Debian<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
Вилучення налаштувань для веб-сервера Apache2<br />
<br />
rm /etc/apache2/sites-enabled/ukr_unimarc.conf<br />
rm /etc/apache2/sites-available/ukr_unimarc.conf<br />
<br />
Якщо після видалення планується перевстановлення Коха, то ще потрібно <br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9246Встановлення Koha з репозитарію на ОС Debian2024-01-16T21:46:29Z<p>Dubyk: /* Кроки веб-встановлювача */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.11.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:<br />
<br />
Встановити gpg<br />
apt-get install gnupg2<br />
<br />
Звантажити та встановити ключ<br />
<br />
Новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або старіший спосіб<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).<br />
<br />
Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою<br />
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<br />
<br />
Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр<br />
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<br />
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<br />
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<br />
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<br />
'''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'''<br />
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<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 12.2023 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
<br />
* '''Locale::XGettext::TT2'''<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
<br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці<br />
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA<br />
разом з раніше скопійованими '''SQL'''-файлами.<br />
<br />
Також можете встановити деякі інші мови інтерфейсу<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „ukr_unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль та логін можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі¹²''' '''дані''', імпорт 1-10 хв.).<br />
<br />
¹Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
²Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
Вилучення налаштувань для веб-сервера Apache2<br />
<br />
rm /etc/apache2/sites-enabled/ukr_unimarc.conf<br />
rm /etc/apache2/sites-available/ukr_unimarc.conf<br />
<br />
Якщо після видалення планується перевстановлення Коха, то ще потрібно <br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9245Встановлення Koha з репозитарію на ОС Debian2024-01-16T13:09:57Z<p>Dubyk: /* Кроки веб-встановлювача */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.11.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:<br />
<br />
Встановити gpg<br />
apt-get install gnupg2<br />
<br />
Звантажити та встановити ключ<br />
<br />
Новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або старіший спосіб<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).<br />
<br />
Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою<br />
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<br />
<br />
Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр<br />
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<br />
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<br />
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<br />
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<br />
'''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'''<br />
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<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 12.2023 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
<br />
* '''Locale::XGettext::TT2'''<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
<br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці<br />
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA<br />
разом з раніше скопійованими '''SQL'''-файлами.<br />
<br />
Також можете встановити деякі інші мови інтерфейсу<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „ukr_unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль та логін можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' '''дані''', імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
Вилучення налаштувань для веб-сервера Apache2<br />
<br />
rm /etc/apache2/sites-enabled/ukr_unimarc.conf<br />
rm /etc/apache2/sites-available/ukr_unimarc.conf<br />
<br />
Якщо після видалення планується перевстановлення Коха, то ще потрібно <br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9244Встановлення Koha з репозитарію на ОС Debian2024-01-16T13:09:28Z<p>Dubyk: /* Кроки веб-встановлювача */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.11.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:<br />
<br />
Встановити gpg<br />
apt-get install gnupg2<br />
<br />
Звантажити та встановити ключ<br />
<br />
Новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або старіший спосіб<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).<br />
<br />
Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою<br />
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<br />
<br />
Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр<br />
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<br />
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<br />
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<br />
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<br />
'''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'''<br />
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<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 12.2023 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
<br />
* '''Locale::XGettext::TT2'''<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
<br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці<br />
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA<br />
разом з раніше скопійованими '''SQL'''-файлами.<br />
<br />
Також можете встановити деякі інші мови інтерфейсу<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль та логін можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' '''дані''', імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
Вилучення налаштувань для веб-сервера Apache2<br />
<br />
rm /etc/apache2/sites-enabled/ukr_unimarc.conf<br />
rm /etc/apache2/sites-available/ukr_unimarc.conf<br />
<br />
Якщо після видалення планується перевстановлення Коха, то ще потрібно <br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9243Встановлення Koha з репозитарію на ОС Debian2024-01-15T16:50:36Z<p>Dubyk: /* Підключення репозитарію Koha */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.11.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:<br />
<br />
Встановити gpg<br />
apt-get install gnupg2<br />
<br />
Звантажити та встановити ключ<br />
<br />
Новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або старіший спосіб<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).<br />
<br />
Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою<br />
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<br />
<br />
Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр<br />
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<br />
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<br />
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<br />
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<br />
'''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'''<br />
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<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 12.2023 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
<br />
* '''Locale::XGettext::TT2'''<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
<br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці<br />
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA<br />
разом з раніше скопійованими '''SQL'''-файлами.<br />
<br />
Також можете встановити деякі інші мови інтерфейсу<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' '''дані''', імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
Вилучення налаштувань для веб-сервера Apache2<br />
<br />
rm /etc/apache2/sites-enabled/ukr_unimarc.conf<br />
rm /etc/apache2/sites-available/ukr_unimarc.conf<br />
<br />
Якщо після видалення планується перевстановлення Коха, то ще потрібно <br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9242Встановлення Koha з репозитарію на ОС Debian2024-01-15T16:49:47Z<p>Dubyk: /* Підключення репозитарію Koha */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.11.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Спочатку додаємо ключ gpg.asc (koha-keyring.gpg) до довірених ключів APT:<br />
<br />
Встановити gpg<br />
apt-get install gnupg2<br />
<br />
Звантажити та встановити ключ<br />
<br />
Новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або старіший спосіб<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
Швидко підключити репозитарій стабільну версію Koha (рекомендується) можна командою<br />
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<br />
<br />
Також можна вибрати репозитарій з певною версією (див. тут http://debian.koha-community.org/koha/dists/), напр<br />
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<br />
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<br />
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<br />
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<br />
'''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'''<br />
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<br />
<br />
Див. також [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty]).<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 12.2023 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
<br />
* '''Locale::XGettext::TT2'''<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
<br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці<br />
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA<br />
разом з раніше скопійованими '''SQL'''-файлами.<br />
<br />
Також можете встановити деякі інші мови інтерфейсу<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' '''дані''', імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
Вилучення налаштувань для веб-сервера Apache2<br />
<br />
rm /etc/apache2/sites-enabled/ukr_unimarc.conf<br />
rm /etc/apache2/sites-available/ukr_unimarc.conf<br />
<br />
Якщо після видалення планується перевстановлення Коха, то ще потрібно <br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9241Встановлення Koha з репозитарію на ОС Debian2024-01-07T21:30:54Z<p>Dubyk: </p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.11.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
'''echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''<br />
echo 'deb http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
<br />
Новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або старіший спосіб<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 12.2023 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
<br />
* '''Locale::XGettext::TT2'''<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
<br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці<br />
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA<br />
разом з раніше скопійованими '''SQL'''-файлами.<br />
<br />
Також можете встановити деякі інші мови інтерфейсу<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' '''дані''', імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
Вилучення налаштувань для веб-сервера Apache2<br />
<br />
rm /etc/apache2/sites-enabled/ukr_unimarc.conf<br />
rm /etc/apache2/sites-available/ukr_unimarc.conf<br />
<br />
Якщо після видалення планується перевстановлення Коха, то ще потрібно <br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%86%D1%81%D1%82%D0%BE%D1%80%D1%96%D1%8F_%D0%B2%D0%B5%D1%80%D1%81%D1%96%D0%B9_%D0%90%D0%91%D0%86%D0%A1_Koha&diff=9240Історія версій АБІС Koha2024-01-07T20:25:18Z<p>Dubyk: </p>
<hr />
<div>В цій історій версій АБІС Koha наведені найбільш видимі зміни. Детальніше дивіться за посиланням до кожної версії. <br />
<br />
* [https://koha-community.org/koha-23-11-01-released/ Koha 23.11.01] (2 січня 2024 року)<br />
<br />
* '''[https://koha-community.org/koha-23-11-release/ Koha 23.11]''' (30 листопада 2023 р)<br />
<br />
* '''[https://koha-community.org/koha-23-05-release/ Koha 23.05]''' (1 червня 2023 року)<br />
<br />
* '''[https://koha-community.org/koha-22-11-released/ Koha 21.11]''' (25 листопада 2022 року)<br />
<br />
* '''[https://koha-community.org/koha-22-05-release/ Koha 22.05]''' (28 травня 2022 року)<br />
<br />
* [https://koha-community.org/koha-21-11-01-released/ Koha 21.11.01] (22 грудня 2021 року)<br />
<br />
* [https://koha-community.org/koha-21-05-08-released/ Koha 21.05.08] (23 грудня 2021 року)<br />
<br />
* '''[https://koha-community.org/koha-21-11-released/ Koha 21.11]''' (25 листопада 2021 року)<br />
<br />
* '''[https://koha-community.org/koha-21-05-released/ Koha 21.05]''' (28 травня 2021 року)<br />
<br />
* [https://koha-community.org/koha-20-11-03-released/ Koha 20.11.03] (24 лютого 2021 року)<br />
<br />
* [https://koha-community.org/koha-20-11-02-released/ Koha 20.11.02] (23 січня 2021 року)<br />
<br />
* [https://koha-community.org/koha-20-11-01-released/ Koha 20.11.01] (7 січня 2021 року)<br />
<br />
* '''[https://koha-community.org/koha-20-11-released/ Koha 20.11]''' (27 листопада 2020 року)<br />
<br />
* [https://koha-community.org/koha-20-05-05-release/ Koha 20.05.05] (27 жовтня 2020 року)<br />
<br />
* [https://koha-community.org/koha-20-05-01-release/ Koha 20.05.01] (23 червня 2020 року)<br />
<br />
* '''[https://koha-community.org/koha-20-05-release/ Koha 20.05]''' (31 травня 2020 року), [[Примітки до випуску Koha 20.05]] (укр.)<br />
<br />
* [https://koha-community.org/koha-19-11-06-release/ Koha 19.11.06] (21 травня 2020 року)<br />
<br />
* [https://koha-community.org/koha-19-11-05-release/ Koha 19.11.05] (22 квітня 2020 року)<br />
<br />
* [https://koha-community.org/koha-19-11-04-release/ Koha 19.11.04] (24 березня 2020 року)<br />
<br />
* [https://koha-community.org/koha-19-11-03-release/ Koha 19.11.03] (21 лютого 2020 року)<br />
<br />
* [https://koha-community.org/koha-19-11-02-release/ Koha 19.11.02] (22 січня 2020 року)<br />
<br />
* [https://koha-community.org/koha-19-11-01-release/ Koha 19.11.01] (23 грудня 2019 року)<br />
<br />
* '''[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)<br />
<br />
* [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)<br />
<br />
* [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)<br />
- [https://translate.koha-community.org/uk/19.05/ український переклад 71.3%]<br />
<br />
* [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)<br />
<br />
* [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), <br />
- оновлення безпеки (міжсайтовий скриптинг, XSS)<br />
<br />
* [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]] (укр.)<br />
- пропозиції на придбання на e-mail, база знань Mana для обміну звітами та підписками, вдосконалено МАРК-редактор<br />
<br />
* [https://koha-community.org/koha-18-11-05-release/ Koha 18.11.05] (3 травня 2019)<br />
<br />
* [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)<br />
<br />
* [https://koha-community.org/koha-18-11-03-release/ Koha 18.11.03] (23 лютого 2019)<br />
<br />
* [https://koha-community.org/koha-18-11-01-release/ Koha 18.11.01] (21 грудня 2018)<br />
<br />
* [https://koha-community.org/koha-18-11-release/ Koha 18.11.00], [[Примітки до випуску Koha 18.11]] (укр.)<br />
<br />
- ротація бібліотечних фондів<br />
<br />
- документація переведена в онлайн<br />
<br />
- підтримка каталогу RecordedBooks, обкладинок AdLibris<br />
<br />
- нові REST api для відвідувачів та маршрутів <br />
<br />
- діаграми у звітах<br />
<br />
- підтримка SRU для запозичень авторитетних файлів<br />
<br />
- покращення безпеки автентифікації, SQL, XSS<br />
<br />
- типові значення для індикаторів<br />
<br />
- підтримка множинних форм у перекладах<br />
<br />
- отримання згоди на обробку персональних даних (GDPR)<br />
<br />
- українською перекладено 58,9% загалом: електронний каталог 100%, інтерфейс бібліотекаря %60,7, параметри 31,1%, Unimarc 100%, Marc21 32,1%<br />
<br />
* [https://koha-community.org/koha-18-05-released/ Koha 18.05.00] <br />
<br />
- ієрархії бібліотек та підрозділів<br />
<br />
- кешування Plack та Memcached визнано стабільними<br />
<br />
- краща підтримка Unicode<br />
<br />
- інструмент об’єднання записів читачів<br />
<br />
- підтримка OAuth2<br />
<br />
- імпорт читачів з командного рядка<br />
<br />
- змінна MarcFieldDocURL для посилання на МАРК-документацію, напр. MarcFieldDocURL=https://unimarc.org.ua/wiki/index.php/{FIELD}<br />
<br />
- структура ACQ для надходжень<br />
<br />
- вдосконалення підтримки Elasticsearch<br />
<br />
* [https://koha-community.org/koha-17-11-released/ Koha 17.11.00] <br />
<br />
- історія пені та платежів<br />
<br />
- онлайн-платежі<br />
<br />
- підтримка МБА-обмінів<br />
<br />
- зведення для читача (його видачі, прострочення, резервування, сплати)<br />
<br />
- історія резервувань<br />
<br />
- зріс укр.-переклад, оновлено укр.-налаштування <br />
<br />
* [https://koha-community.org/koha-17-05-released/ Koha 17.05.00], [http://koha.org.ua/novini/vyjshla-koha-17-05/ Вийшла Koha 17.05](укр.)<br />
<br />
- запити на скан/ксерокс статей чи частин книг<br />
<br />
- після-інсталяційний покроковий чарівник<br />
<br />
- сповіщення різними мовами<br />
<br />
- читач може робити примітки до виданих йому книг<br />
<br />
- клуби читачів за інтересами<br />
<br />
- міжбібліотечна статистика https://hea.koha-community.org/ <br />
<br />
- зміна поведінки звітів на основі marcxml<br />
<br />
* [https://koha-community.org/koha-16-11-released-2/ Koha 16.11.00]<br />
<br />
- відправлення постачальникам замовлення по пошті<br />
<br />
- модуль прикутих до дому<br />
<br />
* [https://koha-community.org/koha-16-05-released/ Koha 16.05.00]<br />
<br />
- авторизація Google OAuth2 (OpenID Connect)<br />
<br />
- відновлення забутого паролю<br />
<br />
* [https://koha-community.org/koha-3-22-released/ Koha 3.22] (листопад 2015)<br />
<br />
- додавання файлів до бібліографічних записів (upload.pl)<br />
<br />
- пришвидшення Коха (технологія Plack)<br />
<br />
- редактор професійного каталогізатора<br />
<br />
- sitemap.pl для пошукових рушіїв (Google,...)<br />
<br />
* [https://koha-community.org/koha-3-20-0-released/ Koha 3.20] (травень 2015)<br />
<br />
- пакетна обробка біб-записів<br />
<br />
- імпорт біб-файлів різних форматів через додатки<br />
<br />
- підтримка обкладинок через віддалений кеш Coce<br />
<br />
* [https://koha-community.org/koha-3-18-0-released/ Koha 3.18] (листопад 2014)<br />
<br />
- завантаження сканованих накладних<br />
<br />
- підтримка граней (при пошуку)<br />
<br />
- пакетне вилучення біб-записів<br />
<br />
- почергово переміщувані зібрання<br />
<br />
- підтримка запозичень SRU (на додаток до Z39-50), можливість конвертації Marc21-Unimarc на льоту<br />
<br />
* [https://koha-community.org/koha-3-16-0-released/ Koha 3.16] (травень 2014)<br />
<br />
- індексатор Zebra працює як служба<br />
<br />
- надсилання списків ел.поштою<br />
<br />
* [https://koha-community.org/koha-3-14-0-released/ Koha 3.14] (листопад 2013)<br />
<br />
- нова тема Bootstrap для ЕК (підтримка моб. пристроїв)<br />
<br />
- модуль резервування курсів<br />
<br />
- модуль офлайнового обігу<br />
<br />
- переліки відвідувачів<br />
<br />
- правила конвертування при імпорті біб-записів<br />
<br />
- імпорт авторит. файлів через Z39-50<br />
<br />
- підтримка мікроданих schema.org<br />
<br />
* [https://koha-community.org/koha-3-12-0-released/ Koha 3.12] (травень 2013)<br />
<br />
- підтримка HTML5 відео/аудіо<br />
<br />
- само-реєстрація відвідувачів<br />
<br />
- підтримка додатків<br />
<br />
- статистика по відвідувачах<br />
<br />
* [https://koha-community.org/koha-3-10-0-released/ Koha 3.10] (листопад 2012)<br />
<br />
- додаток для інвентарного номера<br />
<br />
- ''тихий'' видрук квитанцій<br />
<br />
- вікові обмеження<br />
<br />
- режим незалежних підрозділів<br />
<br />
- скрипт MARC-експорту<br />
<br />
- цитати дня<br />
<br />
- обкладинки у списках<br />
<br />
- пакетне редагування відвідувачів<br />
<br />
- додавання PDF-файлів у профіль відвідувача<br />
<br />
- ієрархія збережених звітів<br />
<br />
- ширше-вужче-пов’язано для тематик, до цього відноситься „Чи ви мали на увазі?“<br />
<br />
- підтримка SIP2<br />
<br />
- підрозподілені привілеї<br />
<br />
- таблиці в Koha<br />
<br />
* [https://koha-community.org/koha-3-8-0-released/ Koha 3.8.0] (квітень 2012)<br />
<br />
- локальні обладинки<br />
<br />
- аналітичні записи<br />
<br />
- додаткок для шифру callnumber-KU<br />
<br />
- шлюз OCLC Connexion<br />
<br />
- пошукові посилання у подробицях запису<br />
<br />
- XSLT-таблиці для подробиць запису та результатів пошуку<br />
<br />
- зірковий рейтинг в ЕК<br />
<br />
- посилання на соц-мережі<br />
<br />
- підтримка memcached<br />
<br />
* [https://koha-community.org/koha-3-6-0-released/ Koha 3.6.0] (жовтень 2011)<br />
<br />
- покращення для підтримки аналітичних записів<br />
<br />
* [https://koha-community.org/koha-3-4-0-released/ Koha 3.4.0] (квітень 2011)<br />
<br />
* [https://koha-community.org/koha-3-2-0/ Koha 3.2.0] (жовтень 2010)<br />
<br />
- ієрархічні кошториси та кошти<br />
<br />
- пакетне редагування примірників<br />
<br />
- переміщення примірників між записами<br />
<br />
- шукати за цим заголовком (у інших ресурсах)<br />
<br />
- редаговані SQL-звіти<br />
<br />
- OAI-PMH<br />
<br />
- пакування для Debian (apt-get install koha)<br />
<br />
* [https://koha-community.org/koha-3-0-6-ready-for-download/ Koha 3.0.6] (травень 2010)<br />
<br />
* Koha 3.0.0 (серпень 2008)<br />
<br />
Див. також тут https://koha-community.org/about/history/<br />
<br />
Про історію Koha без сухих цифр і дат читайте тут https://wiki.koha-community.org/wiki/History.<br />
<br />
Цікава відео-візуалізація розробки Koha https://www.youtube.com/watch?v=Tl1a2VN_pec&feature=youtu.be</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%86%D1%81%D1%82%D0%BE%D1%80%D1%96%D1%8F_%D0%B2%D0%B5%D1%80%D1%81%D1%96%D0%B9_%D0%90%D0%91%D0%86%D0%A1_Koha&diff=9239Історія версій АБІС Koha2024-01-07T20:23:33Z<p>Dubyk: </p>
<hr />
<div>В цій історій версій АБІС Koha наведені найбільш видимі зміни. Детальніше дивіться за посиланням до кожної версії. <br />
<br />
* '''[https://koha-community.org/koha-23-11-release/ Koha 23.11]''' (30 листопада 2023 р)<br />
<br />
* '''[https://koha-community.org/koha-23-05-release/ Koha 23.05]''' (1 червня 2023 року)<br />
<br />
* '''[https://koha-community.org/koha-22-11-released/ Koha 21.11]''' (25 листопада 2022 року)<br />
<br />
* '''[https://koha-community.org/koha-22-05-release/ Koha 22.05]''' (28 травня 2022 року)<br />
<br />
* [https://koha-community.org/koha-21-11-01-released/ Koha 21.11.01] (22 грудня 2021 року)<br />
<br />
* [https://koha-community.org/koha-21-05-08-released/ Koha 21.05.08] (23 грудня 2021 року)<br />
<br />
* '''[https://koha-community.org/koha-21-11-released/ Koha 21.11]''' (25 листопада 2021 року)<br />
<br />
* '''[https://koha-community.org/koha-21-05-released/ Koha 21.05]''' (28 травня 2021 року)<br />
<br />
* [https://koha-community.org/koha-20-11-03-released/ Koha 20.11.03] (24 лютого 2021 року)<br />
<br />
* [https://koha-community.org/koha-20-11-02-released/ Koha 20.11.02] (23 січня 2021 року)<br />
<br />
* [https://koha-community.org/koha-20-11-01-released/ Koha 20.11.01] (7 січня 2021 року)<br />
<br />
* '''[https://koha-community.org/koha-20-11-released/ Koha 20.11]''' (27 листопада 2020 року)<br />
<br />
* [https://koha-community.org/koha-20-05-05-release/ Koha 20.05.05] (27 жовтня 2020 року)<br />
<br />
* [https://koha-community.org/koha-20-05-01-release/ Koha 20.05.01] (23 червня 2020 року)<br />
<br />
* '''[https://koha-community.org/koha-20-05-release/ Koha 20.05]''' (31 травня 2020 року), [[Примітки до випуску Koha 20.05]] (укр.)<br />
<br />
* [https://koha-community.org/koha-19-11-06-release/ Koha 19.11.06] (21 травня 2020 року)<br />
<br />
* [https://koha-community.org/koha-19-11-05-release/ Koha 19.11.05] (22 квітня 2020 року)<br />
<br />
* [https://koha-community.org/koha-19-11-04-release/ Koha 19.11.04] (24 березня 2020 року)<br />
<br />
* [https://koha-community.org/koha-19-11-03-release/ Koha 19.11.03] (21 лютого 2020 року)<br />
<br />
* [https://koha-community.org/koha-19-11-02-release/ Koha 19.11.02] (22 січня 2020 року)<br />
<br />
* [https://koha-community.org/koha-19-11-01-release/ Koha 19.11.01] (23 грудня 2019 року)<br />
<br />
* '''[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)<br />
<br />
* [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)<br />
<br />
* [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)<br />
- [https://translate.koha-community.org/uk/19.05/ український переклад 71.3%]<br />
<br />
* [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)<br />
<br />
* [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), <br />
- оновлення безпеки (міжсайтовий скриптинг, XSS)<br />
<br />
* [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]] (укр.)<br />
- пропозиції на придбання на e-mail, база знань Mana для обміну звітами та підписками, вдосконалено МАРК-редактор<br />
<br />
* [https://koha-community.org/koha-18-11-05-release/ Koha 18.11.05] (3 травня 2019)<br />
<br />
* [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)<br />
<br />
* [https://koha-community.org/koha-18-11-03-release/ Koha 18.11.03] (23 лютого 2019)<br />
<br />
* [https://koha-community.org/koha-18-11-01-release/ Koha 18.11.01] (21 грудня 2018)<br />
<br />
* [https://koha-community.org/koha-18-11-release/ Koha 18.11.00], [[Примітки до випуску Koha 18.11]] (укр.)<br />
<br />
- ротація бібліотечних фондів<br />
<br />
- документація переведена в онлайн<br />
<br />
- підтримка каталогу RecordedBooks, обкладинок AdLibris<br />
<br />
- нові REST api для відвідувачів та маршрутів <br />
<br />
- діаграми у звітах<br />
<br />
- підтримка SRU для запозичень авторитетних файлів<br />
<br />
- покращення безпеки автентифікації, SQL, XSS<br />
<br />
- типові значення для індикаторів<br />
<br />
- підтримка множинних форм у перекладах<br />
<br />
- отримання згоди на обробку персональних даних (GDPR)<br />
<br />
- українською перекладено 58,9% загалом: електронний каталог 100%, інтерфейс бібліотекаря %60,7, параметри 31,1%, Unimarc 100%, Marc21 32,1%<br />
<br />
* [https://koha-community.org/koha-18-05-released/ Koha 18.05.00] <br />
<br />
- ієрархії бібліотек та підрозділів<br />
<br />
- кешування Plack та Memcached визнано стабільними<br />
<br />
- краща підтримка Unicode<br />
<br />
- інструмент об’єднання записів читачів<br />
<br />
- підтримка OAuth2<br />
<br />
- імпорт читачів з командного рядка<br />
<br />
- змінна MarcFieldDocURL для посилання на МАРК-документацію, напр. MarcFieldDocURL=https://unimarc.org.ua/wiki/index.php/{FIELD}<br />
<br />
- структура ACQ для надходжень<br />
<br />
- вдосконалення підтримки Elasticsearch<br />
<br />
* [https://koha-community.org/koha-17-11-released/ Koha 17.11.00] <br />
<br />
- історія пені та платежів<br />
<br />
- онлайн-платежі<br />
<br />
- підтримка МБА-обмінів<br />
<br />
- зведення для читача (його видачі, прострочення, резервування, сплати)<br />
<br />
- історія резервувань<br />
<br />
- зріс укр.-переклад, оновлено укр.-налаштування <br />
<br />
* [https://koha-community.org/koha-17-05-released/ Koha 17.05.00], [http://koha.org.ua/novini/vyjshla-koha-17-05/ Вийшла Koha 17.05](укр.)<br />
<br />
- запити на скан/ксерокс статей чи частин книг<br />
<br />
- після-інсталяційний покроковий чарівник<br />
<br />
- сповіщення різними мовами<br />
<br />
- читач може робити примітки до виданих йому книг<br />
<br />
- клуби читачів за інтересами<br />
<br />
- міжбібліотечна статистика https://hea.koha-community.org/ <br />
<br />
- зміна поведінки звітів на основі marcxml<br />
<br />
* [https://koha-community.org/koha-16-11-released-2/ Koha 16.11.00]<br />
<br />
- відправлення постачальникам замовлення по пошті<br />
<br />
- модуль прикутих до дому<br />
<br />
* [https://koha-community.org/koha-16-05-released/ Koha 16.05.00]<br />
<br />
- авторизація Google OAuth2 (OpenID Connect)<br />
<br />
- відновлення забутого паролю<br />
<br />
* [https://koha-community.org/koha-3-22-released/ Koha 3.22] (листопад 2015)<br />
<br />
- додавання файлів до бібліографічних записів (upload.pl)<br />
<br />
- пришвидшення Коха (технологія Plack)<br />
<br />
- редактор професійного каталогізатора<br />
<br />
- sitemap.pl для пошукових рушіїв (Google,...)<br />
<br />
* [https://koha-community.org/koha-3-20-0-released/ Koha 3.20] (травень 2015)<br />
<br />
- пакетна обробка біб-записів<br />
<br />
- імпорт біб-файлів різних форматів через додатки<br />
<br />
- підтримка обкладинок через віддалений кеш Coce<br />
<br />
* [https://koha-community.org/koha-3-18-0-released/ Koha 3.18] (листопад 2014)<br />
<br />
- завантаження сканованих накладних<br />
<br />
- підтримка граней (при пошуку)<br />
<br />
- пакетне вилучення біб-записів<br />
<br />
- почергово переміщувані зібрання<br />
<br />
- підтримка запозичень SRU (на додаток до Z39-50), можливість конвертації Marc21-Unimarc на льоту<br />
<br />
* [https://koha-community.org/koha-3-16-0-released/ Koha 3.16] (травень 2014)<br />
<br />
- індексатор Zebra працює як служба<br />
<br />
- надсилання списків ел.поштою<br />
<br />
* [https://koha-community.org/koha-3-14-0-released/ Koha 3.14] (листопад 2013)<br />
<br />
- нова тема Bootstrap для ЕК (підтримка моб. пристроїв)<br />
<br />
- модуль резервування курсів<br />
<br />
- модуль офлайнового обігу<br />
<br />
- переліки відвідувачів<br />
<br />
- правила конвертування при імпорті біб-записів<br />
<br />
- імпорт авторит. файлів через Z39-50<br />
<br />
- підтримка мікроданих schema.org<br />
<br />
* [https://koha-community.org/koha-3-12-0-released/ Koha 3.12] (травень 2013)<br />
<br />
- підтримка HTML5 відео/аудіо<br />
<br />
- само-реєстрація відвідувачів<br />
<br />
- підтримка додатків<br />
<br />
- статистика по відвідувачах<br />
<br />
* [https://koha-community.org/koha-3-10-0-released/ Koha 3.10] (листопад 2012)<br />
<br />
- додаток для інвентарного номера<br />
<br />
- ''тихий'' видрук квитанцій<br />
<br />
- вікові обмеження<br />
<br />
- режим незалежних підрозділів<br />
<br />
- скрипт MARC-експорту<br />
<br />
- цитати дня<br />
<br />
- обкладинки у списках<br />
<br />
- пакетне редагування відвідувачів<br />
<br />
- додавання PDF-файлів у профіль відвідувача<br />
<br />
- ієрархія збережених звітів<br />
<br />
- ширше-вужче-пов’язано для тематик, до цього відноситься „Чи ви мали на увазі?“<br />
<br />
- підтримка SIP2<br />
<br />
- підрозподілені привілеї<br />
<br />
- таблиці в Koha<br />
<br />
* [https://koha-community.org/koha-3-8-0-released/ Koha 3.8.0] (квітень 2012)<br />
<br />
- локальні обладинки<br />
<br />
- аналітичні записи<br />
<br />
- додаткок для шифру callnumber-KU<br />
<br />
- шлюз OCLC Connexion<br />
<br />
- пошукові посилання у подробицях запису<br />
<br />
- XSLT-таблиці для подробиць запису та результатів пошуку<br />
<br />
- зірковий рейтинг в ЕК<br />
<br />
- посилання на соц-мережі<br />
<br />
- підтримка memcached<br />
<br />
* [https://koha-community.org/koha-3-6-0-released/ Koha 3.6.0] (жовтень 2011)<br />
<br />
- покращення для підтримки аналітичних записів<br />
<br />
* [https://koha-community.org/koha-3-4-0-released/ Koha 3.4.0] (квітень 2011)<br />
<br />
* [https://koha-community.org/koha-3-2-0/ Koha 3.2.0] (жовтень 2010)<br />
<br />
- ієрархічні кошториси та кошти<br />
<br />
- пакетне редагування примірників<br />
<br />
- переміщення примірників між записами<br />
<br />
- шукати за цим заголовком (у інших ресурсах)<br />
<br />
- редаговані SQL-звіти<br />
<br />
- OAI-PMH<br />
<br />
- пакування для Debian (apt-get install koha)<br />
<br />
* [https://koha-community.org/koha-3-0-6-ready-for-download/ Koha 3.0.6] (травень 2010)<br />
<br />
* Koha 3.0.0 (серпень 2008)<br />
<br />
Див. також тут https://koha-community.org/about/history/<br />
<br />
Про історію Koha без сухих цифр і дат читайте тут https://wiki.koha-community.org/wiki/History.<br />
<br />
Цікава відео-візуалізація розробки Koha https://www.youtube.com/watch?v=Tl1a2VN_pec&feature=youtu.be</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9238Встановлення Koha з репозитарію на ОС Debian2024-01-06T19:56:04Z<p>Dubyk: /* Кроки веб-встановлювача */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
'''echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''<br />
echo 'deb http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
<br />
Новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або старіший спосіб<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 12.2023 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
<br />
* '''Locale::XGettext::TT2'''<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
<br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці<br />
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA<br />
разом з раніше скопійованими '''SQL'''-файлами.<br />
<br />
Також можете встановити деякі інші мови інтерфейсу<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' '''дані''', імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
Також варто вимкнути типову структуру unimarc_sample_fastadd_framework (вона конфліктує з unimarc_sample_fastadd_framework_FA_UKR) у блоці „Факультативне“.<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
Вилучення налаштувань для веб-сервера Apache2<br />
<br />
rm /etc/apache2/sites-enabled/ukr_unimarc.conf<br />
rm /etc/apache2/sites-available/ukr_unimarc.conf<br />
<br />
Якщо після видалення планується перевстановлення Коха, то ще потрібно <br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9237Встановлення Koha з репозитарію на ОС Debian2023-12-18T08:23:28Z<p>Dubyk: /* Процес імпорту даних */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
'''echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''<br />
echo 'deb http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
<br />
Новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або старіший спосіб<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 12.2023 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
<br />
* '''Locale::XGettext::TT2'''<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
<br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці<br />
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA<br />
разом з раніше скопійованими '''SQL'''-файлами.<br />
<br />
Також можете встановити деякі інші мови інтерфейсу<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' '''дані''', імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску веб-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
Вилучення налаштувань для веб-сервера Apache2<br />
<br />
rm /etc/apache2/sites-enabled/ukr_unimarc.conf<br />
rm /etc/apache2/sites-available/ukr_unimarc.conf<br />
<br />
Якщо після видалення планується перевстановлення Коха, то ще потрібно <br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9236Встановлення Koha з репозитарію на ОС Debian2023-12-18T00:17:56Z<p>Dubyk: /* Кроки веб-встановлювача */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
'''echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''<br />
echo 'deb http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
<br />
Новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або старіший спосіб<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 12.2023 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
<br />
* '''Locale::XGettext::TT2'''<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
<br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці<br />
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA<br />
разом з раніше скопійованими '''SQL'''-файлами.<br />
<br />
Також можете встановити деякі інші мови інтерфейсу<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' '''дані''', імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску dt,-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
Вилучення налаштувань для веб-сервера Apache2<br />
<br />
rm /etc/apache2/sites-enabled/ukr_unimarc.conf<br />
rm /etc/apache2/sites-available/ukr_unimarc.conf<br />
<br />
Якщо після видалення планується перевстановлення Коха, то ще потрібно <br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9235Встановлення Koha з репозитарію на ОС Debian2023-12-18T00:17:34Z<p>Dubyk: /* Кроки веб-встановлювача */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
'''echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''<br />
echo 'deb http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
<br />
Новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або старіший спосіб<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 12.2023 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
<br />
* '''Locale::XGettext::TT2'''<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
<br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці<br />
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA<br />
разом з раніше скопійованими '''SQL'''-файлами.<br />
<br />
Також можете встановити деякі інші мови інтерфейсу<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' '''дані''', імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску Koha-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
Вилучення налаштувань для веб-сервера Apache2<br />
<br />
rm /etc/apache2/sites-enabled/ukr_unimarc.conf<br />
rm /etc/apache2/sites-available/ukr_unimarc.conf<br />
<br />
Якщо після видалення планується перевстановлення Коха, то ще потрібно <br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9234Встановлення Koha з репозитарію на ОС Debian2023-12-18T00:05:48Z<p>Dubyk: /* Утворення локалізованих шаблонів */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
'''echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''<br />
echo 'deb http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
<br />
Новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або старіший спосіб<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 12.2023 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
<br />
* '''Locale::XGettext::TT2'''<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
<br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
Ця команда також згенерує деякі перекладені дані для Коха (у форматі '''yaml'''-файлів) у теці<br />
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA<br />
разом з раніше скопійованими '''SQL'''-файлами.<br />
<br />
Також можете встановити деякі інші мови інтерфейсу<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
Вилучення налаштувань для веб-сервера Apache2<br />
<br />
rm /etc/apache2/sites-enabled/ukr_unimarc.conf<br />
rm /etc/apache2/sites-available/ukr_unimarc.conf<br />
<br />
Якщо після видалення планується перевстановлення Коха, то ще потрібно <br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9233Встановлення Koha з репозитарію на ОС Debian2023-12-18T00:05:12Z<p>Dubyk: /* Утворення локалізованих шаблонів */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
'''echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''<br />
echo 'deb http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
<br />
Новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або старіший спосіб<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 12.2023 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
<br />
* '''Locale::XGettext::TT2'''<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
<br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
Ця команда також згенерує деякі перекладені дані для Коха (у форматі yaml-файлів) у теці<br />
/usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA<br />
разом з раніше скопійованими sql-файлами.<br />
<br />
Також можете встановити деякі інші мови інтерфейсу<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
Вилучення налаштувань для веб-сервера Apache2<br />
<br />
rm /etc/apache2/sites-enabled/ukr_unimarc.conf<br />
rm /etc/apache2/sites-available/ukr_unimarc.conf<br />
<br />
Якщо після видалення планується перевстановлення Коха, то ще потрібно <br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9232Встановлення Koha з репозитарію на ОС Debian2023-12-17T23:48:14Z<p>Dubyk: /* Вилучення Koha */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
'''echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''<br />
echo 'deb http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
<br />
Новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або старіший спосіб<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 12.2023 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
<br />
* '''Locale::XGettext::TT2'''<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
<br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
Вилучення налаштувань для веб-сервера Apache2<br />
<br />
rm /etc/apache2/sites-enabled/ukr_unimarc.conf<br />
rm /etc/apache2/sites-available/ukr_unimarc.conf<br />
<br />
Якщо після видалення планується перевстановлення Коха, то ще потрібно <br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9231Встановлення Koha з репозитарію на ОС Debian2023-12-17T23:20:59Z<p>Dubyk: /* Вилучення Koha */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
'''echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''<br />
echo 'deb http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
<br />
Новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або старіший спосіб<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 12.2023 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
<br />
* '''Locale::XGettext::TT2'''<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
<br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
Вилучення налаштувань для веб-сервера Apache2<br />
<br />
rm /etc/apache2/sites-enabled/ukr_unimarc.conf<br />
rm /etc/apache2/sites-available/ukr_unimarc.conf<br />
<br />
Якщо після видалення планується перевстановлення Коха, то ще потрібно <br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9230Встановлення Koha з репозитарію на ОС Debian2023-12-17T21:43:13Z<p>Dubyk: /* Пакунки з CPAN */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
'''echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''<br />
echo 'deb http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
<br />
Новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або старіший спосіб<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 12.2023 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
<br />
* '''Locale::XGettext::TT2'''<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
<br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9229Встановлення Koha з репозитарію на ОС Debian2023-12-17T21:43:04Z<p>Dubyk: /* Пакунки з CPAN */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
'''echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''<br />
echo 'deb http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
<br />
Новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або старіший спосіб<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 12.2023 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
<br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9228Встановлення Koha з репозитарію на ОС Debian2023-12-17T21:42:45Z<p>Dubyk: /* Пакунки з CPAN */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
'''echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''<br />
echo 'deb http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
<br />
Новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або старіший спосіб<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 12.2023 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
<br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9227Встановлення Koha з репозитарію на ОС Debian2023-12-17T19:18:45Z<p>Dubyk: /* Встановлення пакунків Koha */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
'''echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''<br />
echo 'deb http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
<br />
Новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або старіший спосіб<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-l10n koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9226Встановлення Koha з репозитарію на ОС Debian2023-12-17T18:28:04Z<p>Dubyk: /* Підключення репозитарію Koha */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
'''echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''<br />
echo 'deb http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
<br />
Новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або старіший спосіб<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9225Встановлення Koha з репозитарію на ОС Debian2023-12-17T18:25:13Z<p>Dubyk: /* Підключення репозитарію Koha */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
'''echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list'''<br />
echo 'deb http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9224Встановлення Koha з репозитарію на ОС Debian2023-12-17T18:23:32Z<p>Dubyk: /* Підключення репозитарію Koha */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9223Встановлення Koha з репозитарію на ОС Debian2023-12-17T17:57:52Z<p>Dubyk: /* Вилучення Koha */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
sudo /etc/init.d/memcached restart<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9222Встановлення Koha з репозитарію на ОС Debian2023-12-17T17:46:57Z<p>Dubyk: /* Вилучення Koha */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
У теці /etc/koha команда „apt-get purge koha-common“ також вилучила більшість файлів. Залишилася тека /etc/koha/sites/ukr_unimarc, її вилучаємо<br />
rm -rf /etc/koha/sites/ukr_unimarc<br />
Також там могли зберегтися конфіг налаштування екземпляра (/etc/koha/koha-ukr-unimarc-site.conf) та інші ваші зміни. Якщо нічого з цього не потрібно, то вилучаємо теку /etc/koha/<br />
rm -rf /etc/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9221Встановлення Koha з репозитарію на ОС Debian2023-12-17T17:41:24Z<p>Dubyk: /* Вилучення Koha */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
У випадку якщо це був останній екземпляр та Вам не потрібна тека /usr/share/koha, то вилучайте й повністю теку /usr/share/koha <br />
rm -rf /usr/share/koha<br />
Примітка: Теку /usr/share/koha мала вилучити команда „apt-get purge koha-common“, однак там могли залишитися файли перекладів чи інші ваші зміни чи долучені файли.<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9220Встановлення Koha з репозитарію на ОС Debian2023-12-17T17:37:00Z<p>Dubyk: /* Вилучення Koha */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/var/cache/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha/ukr_unimarc <br />
<br />
rm -rf /usr/share/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9219Встановлення Koha з репозитарію на ОС Debian2023-12-17T17:35:51Z<p>Dubyk: /* Вилучення Koha */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc <br />
rm -rf /var/cache/koha<br />
rm -rf /usr/share/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9218Встановлення Koha з репозитарію на ОС Debian2023-12-17T17:28:56Z<p>Dubyk: /* Вилучення Koha */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/log/koha<br />
/var/lib/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземпляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/log/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc<br />
rm -rf /usr/share/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9217Встановлення Koha з репозитарію на ОС Debian2023-12-17T17:20:37Z<p>Dubyk: /* Вилучення Koha */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo /sbin/userdel ukr_unimarc-koha<br />
sudo /sbin/groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/lib/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc<br />
rm -rf /usr/share/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%9F%D0%BE%D1%88%D0%B8%D1%80%D0%B5%D0%BD%D0%BD%D1%8F_%D0%90%D0%91%D0%86%D0%A1_Koha_%D0%B2_%D0%A3%D0%BA%D1%80%D0%B0%D1%97%D0%BD%D1%96&diff=9216Поширення АБІС Koha в Україні2023-11-09T16:16:35Z<p>Dubyk: /* Таблиця */</p>
<hr />
<div>== Мапа ==<br />
Див. також на [http://umap.openstreetmap.fr/uk-ua/map/koha_110257 мапі].<br />
<br />
== Таблиця==<br />
{| class="wikitable sortable" <br />
! № п/п<br />
! Назва<br />
! Тип бібліотеки<br />
! Місто<br />
! URL OPAC<br />
! Рік<br />
! Координати<br />
! Версія Koha<br />
! Примітки<br />
! Контакти<br />
<br />
|-<br />
| | 1.<br />
| | [http://library.tntu.edu.ua/ НТБ ТНТУ ім. Ів. Пулюя]<br />
| | університетська<br />
| | Тернопіль<br />
| | [http://koha.tntu.edu.ua/ koha.tntu.edu.ua] <br />
| | 2012<br />
| | [https://www.openstreetmap.org/#map=18/49.5510891/25.5996813 49,5510891, 25,5996813]<br />
| | 18.05.05<br />
| | Unimarc. Міграція з УФД/бібліотека.<br />
| | Сергій Дубик (serhijdubyk@gmail.com) <br />
<br />
|-<br />
| | 2.<br />
| | [http://library.kname.edu.ua/index.php/uk/ Наукова бібліотеки ХНУМГ ім. О. М. Бекетова]<br />
| | університетська<br />
| | Харків<br />
| | [http://koha.kname.edu.ua:8008 koha.kname.edu.ua:8008] <br />
| | 2009<br />
| | [https://www.openstreetmap.org/#map=17/49.9948346/36.2421398 49.9948346, 36.2421398]<br />
| | 3.16.04<br />
| | Unimarc. Розпис статей. Зв’язок з 1С.<br />
| | Надія Євсюкова ([http://library.kname.edu.ua/index.php/uk/pro-biblioteku/struktura-biblioteki-ta-grafik-roboti НБ ХНУМГ]) <br />
<br />
|-<br />
| | 3.<br />
| | [https://lts.lviv.ua/biblioteka/ Бібліотека Львівської богословської семінарії]<br />
| | богословська<br />
| | Львів<br />
| | [https://koha.lts.lviv.ua/ koha.lts.lviv.ua] <br />
| | 2008<br />
| | [http://www.openstreetmap.org/#map=18/49.78958/24.05224 49.78958, 24.05224]<br />
| | 3.06.01<br />
| | Unimarc.<br />
| | Олена Шевчук, С. Дубик<br />
<br />
|-<br />
| | 4.<br />
| | [http://slavutichlib.com.ua/ Загальноміський бібліотечно-інформаційний центр м. Славутич]<br />
| | ЦБС<br />
| | Славутич<br />
| | [http://elib.slavutich.org/ elib.slavutich.org], [http://media.slav.gov.ua/ media.slav.gov.ua], [http://91.192.200.59 91.192.200.59]<br />
| | 2011<br />
| | [https://www.openstreetmap.org/#map=17/51.523443/30.761535 51.523443, 30.761535]<br />
| | 20.05.02<br />
| | Unimarc.<br />
| | Наталія Портная<br />
<br />
|-<br />
| | 5.<br />
| | Бібліотека [http://www.model.poltava.ua/ Вищого професійного училища № 7, Кременчук]<br />
| | училищна<br />
| | Кременчук<br />
| | [http://koha.model.poltava.ua:8080/ koha.model.poltava.ua:8080] <br />
| | 2014<br />
| | [http://www.openstreetmap.org/#map=18/49.09737/33.41087 49.09737, 33.41087]<br />
| | 18.11.05<br />
| | Unimarc.<br />
| | <br />
<br />
|-<br />
| | 6.<br />
| | [http://ktsonline.org/studentu/biblioteka Бібліотека Київської богословської семінарії]<br />
| | богословська<br />
| | Київ<br />
| | [http://koha.kts.org.ua:8080/ koha.kts.org.ua:8080] <br />
| | 2014<br />
| | [https://www.openstreetmap.org/#map=17/50.418844/30.653002 50.418844, 30.653002]<br />
| | 16.11.08<br />
| | Unimarc.<br />
| | ServanTek; С. Дубик <br />
<br />
|-<br />
| | 7.<br />
| | [http://guc.org.ua/%D1%81%D0%BF%D0%B5%D1%86%D1%96%D0%B0%D0%BB%D1%8C%D0%BD%D0%BE%D1%81%D1%82%D1%96/%D0%B1%D1%96%D0%B1%D0%BB%D1%96%D0%BE%D1%82%D0%B5%D0%BA%D0%B0-%D1%83%D1%87%D0%B8%D0%BB%D0%B8%D1%89%D0%B0/ Бібліотека Гадяцького коледжу культури імені І. П. Котляревського]<br />
| | училищна<br />
| | Гадяч<br />
| | [http://guc-koha.boolean.com.ua/ guc-koha.boolean.com.ua] <br />
| | ?<br />
| | [https://www.openstreetmap.org/#map=17/50.37043/33.991234 50.37043, 33.991234]<br />
| | 3.08.08<br />
| | Marc21.<br />
| | <br />
<br />
|-<br />
| | 8. <br />
| | Бібліотека [http://ugi.edu.ua Українського гуманітарного інституту] <br />
| | академічна <br />
| | Буча <br />
| | [https://lib.ugi.edu.ua/ lib.ugi.edu.ua/] <br />
| | 2015 <br />
| | [https://www.openstreetmap.org/#map=17/50.56474/30.24401 50.56474 30.24401] <br />
| | 17.11 <br />
| | Unimarc.<br />
| | Олег Василенко (vasilenko@ugi.edu.ua) <br />
<br />
|-<br />
| | 9. <br />
| | [http://www.uets.net/studentu/biblioteka.html Бібліотека Української євангелічної теологічної семінарії]<br />
| | академічна <br />
| | Київ, Пуща-Водиця <br />
| | [http://lib.uets.net/ lib.uets.net/] <br />
| | 2016 <br />
| | [https://www.openstreetmap.org/#map=17/50.54741/30.34363 50.54741, 30.34363] <br />
| | 17.11 <br />
| | Unimarc.<br />
| | Олег Василенко (vasilenko@ugi.edu.ua) <br />
<br />
|-<br />
| | 10.<br />
| | [http://tomainstytut.org/biblioteka Бібліотека Інституту релігійних наук св. Томи Аквінського]<br />
| | богословська<br />
| | Київ<br />
| | [http://lib.tomainstytut.org lib.tomainstytut.org], [http://kroshko.merlin.net.ua/ kroshko.merlin.net.ua] <br />
| | ?<br />
| | [http://www.openstreetmap.org/?mlat=50.46638&mlon=30.47163#map=18/50.46638/30.47163 50.46638 30.47163]<br />
| | 16.11.07<br />
| | Marc21.<br />
| | <br />
<br />
|-<br />
| | 11.<br />
| | [http://www.odessasem.org/ru/academy-du/library-ru Бібліотека Одеської Богословської Семінарії]<br />
| | богословська<br />
| | Одеса<br />
| | [http://ots-5.dyndns.org ots-5.dyndns.org] <br />
| | 2014<br />
| | [http://www.openstreetmap.org/?mlat=46.58634&mlon=30.76672#map=18/46.58638/30.76672 46.58638 30.76672]<br />
| | 3.16.03<br />
| | Unimarc.<br />
| | <br />
<br />
|-<br />
| | 12.<br />
| | [http://opac.ucu.edu.ua/ Бібліотека Українського католицького університету]<br />
| | богословська<br />
| | Львів<br />
| | [http://opac.ucu.edu.ua/ opac.ucu.edu.ua] <br />
| | 2017<br />
| | [http://www.openstreetmap.org/#map=18/49.8180067/24.0227906 49,8180067 24,0227906]<br />
| | 17.05.06<br />
| | Marc21.<br />
| | Ігор Огура; siteGist<br />
<br />
|-<br />
| | 13.<br />
| | [http://lib.idgu.edu.ua/ Бібліотека Ізмаїльського державного гуманітарного університету]<br />
| | університетська<br />
| | Ізмаїл<br />
| | [http://dspace.idgu.edu.ua:8100/ dspace.idgu.edu.ua:8100] <br />
| | 2018<br />
| | [https://www.openstreetmap.org/#map=17/45.35926/28.82067 45,35926 28,82067]<br />
| | 17.11.05<br />
| | Unimarc.<br />
| | idgulibrary@ukr.net<br />
<br />
|-<br />
| | 14.<br />
| | Бібліотека [https://blog.savebook.net.ua/ Проекту збереження друкованої культурної спадщини]<br />
| | культурний центр<br />
| | Львів<br />
| | [https://savebook.net.ua savebook.net.ua] <br />
| | 2018<br />
| | [https://www.openstreetmap.org/#map=19/49.83584/24.02214 49,83584 24,02214]<br />
| | 18.05.05<br />
| | Unimarc.<br />
| | І. Радковець, С. Дубик<br />
<br />
|-<br />
| | 15.<br />
| | Бібліотека [http://ueckyiv.org/uk/ Українського освітнього центру ім. д-р Мака Уейна Креґа]<br />
| | освітній центр<br />
| | Київ<br />
| | [https://weblamp.ueckyiv.org/ weblamp.ueckyiv.org] <br />
| | 2018<br />
| | [https://www.openstreetmap.org/#map=17/50.45207/30.46565 50,45207 30,46565]<br />
| | 17.11.16<br />
| | Marc21.<br />
| | <br />
<br />
|-<br />
| | 16.<br />
| | [http://biblioteka.lviv.ua Центральна бібліотечна система для дітей м. Львова]<br />
| | ЦБС<br />
| | Львів<br />
| | [https://opac.biblioteka.lviv.ua opac.biblioteka.lviv.ua] <br />
| | 2019<br />
| | [https://www.openstreetmap.org/#map=18/49.85915/24.01835 49,85915 24,01835]<br />
| | 18.11.03<br />
| | Marc21.<br />
| | <br />
<br />
|-<br />
| | 17.<br />
| | Бібліотека [https://hesed-west.org.ua/ Всеукраїнського єврейського благодійного фонду Хесед-Ар'є]<br />
| | культурний центр<br />
| | Львів<br />
| | [https://library.hesed-west.org.ua/ library.hesed-west.org.ua] <br />
| | 2019<br />
| | [https://www.openstreetmap.org/#map=19/49.83111/24.01129 49,83111 24,01129]<br />
| | 18.11.04<br />
| | Unimarc.<br />
| | С. Дубик <br />
<br />
|-<br />
| | 18.<br />
| | Бібліотека [http://tci.org.ua Таврійського християнського інституту]<br />
| | богословська<br />
| | Херсон<br />
| | [https://lib.tci.org.ua lib.tci.org.ua] <br />
| | 2019<br />
| | [https://www.openstreetmap.org/?mlat=46.67387&mlon=32.75409#map=18/46.67387/32.75409 46.67387 32.75409]<br />
| | 19.05.02<br />
| | Unimarc.<br />
| | <br />
<br />
|-<br />
| | 19.<br />
| | Львівська обласна бібліотека для дітей<br />
| | дитяча<br />
| | Львів<br />
| | [https://opac.lodb.org.ua opac.lodb.org.ua] <br />
| | 2019<br />
| | <br />
| | 19.05.02<br />
| | Marc21.<br />
| | <br />
<br />
|-<br />
| | 20.<br />
| | [https://www.lounb.org.ua/ Львівська обласна наукова бібліотека]<br />
| | наукова<br />
| | Львів<br />
| | [https://catalog.lounb.org.ua catalog.lounb.org.ua] <br />
| | 2020<br />
| | <br />
| | 21.05<br />
| | Unimarc.<br />
| | С. Дубик, міграція з Ірбіс. <br />
<br />
|-<br />
| | 21.<br />
| | [https://library.lpnu.ua/ Наукова бібліотека НУ„ЛП“]<br />
| | університетська<br />
| | Львів<br />
| | [https://opac.lpnu.ua opac.lpnu.ua] <br />
| | 2021<br />
| | [http://www.openstreetmap.org/?mlat=49.83550&mlon=24.01674#map=18/49.83550/24.01674&layers=N 49.83550, 24.01674]<br />
| | 23.05<br />
| | Unimarc.<br />
| | С. Дубик, міграція з УФД/Бібліотека. <br />
<br />
|-<br />
| | 22.<br />
| | [https://lib.oa.edu.ua/ Наукова бібліотека Національного університету «Острозька академія»]<br />
| | університетська<br />
| | Острог<br />
| | [https://koha.oa.edu.ua koha.oa.edu.ua] <br />
| | <br />
| | [http://www.openstreetmap.org/?mlat=50.32913&mlon=26.51300#map=18/50.32913/26.51300&layers=N 50.32913, 26.51300]<br />
| | <br />
| | Marc21.<br />
| | Юрій Коцюк, міграція з УФД/Бібліотека<br />
<br />
<br />
<br />
<br />
<br />
|}<br />
<br />
==Див. також==<br />
* [[Бібліотеки, що тестують чи мігрують на АБІС Koha]]<br />
* [https://wiki.koha-community.org/wiki/Category:Koha_Users Переліки встановлень АБІС koha] на офіційній вікі Koha.<br />
* [http://www.librarytechnology.org/map.pl?ILS=Koha Мапа поширення АБІС Koha] на сайті '''librarytechnology.org'''. Вашої бібліотеки немає? — [http://librarytechnology.org/lwc-submit-library.pl зареєструйте].<br />
* [https://hea.koha-community.org HEA - Koha Community Statistics]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9215Встановлення Koha з репозитарію на ОС Debian2023-11-05T19:09:35Z<p>Dubyk: /* Створення нового правила обігу */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
=====Встановлення завершено!=====<br />
Вітаємо, Ви закінчили і готові до використання Коха<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/lib/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc<br />
rm -rf /usr/share/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9214Встановлення Koha з репозитарію на ОС Debian2023-11-05T19:08:51Z<p>Dubyk: /* Створення категорії користувачів */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить.<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
<br />
<br />
Встановлення завершено!<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/lib/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc<br />
rm -rf /usr/share/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9213Встановлення Koha з репозитарію на ОС Debian2023-11-05T19:08:40Z<p>Dubyk: /* Створення нового типу одиниць */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
Якщо у sql-даних були вибрані приклади типів одиниць, то цей крок Коха пропустить.<br />
<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
<br />
<br />
Встановлення завершено!<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/lib/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc<br />
rm -rf /usr/share/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9212Встановлення Koha з репозитарію на ОС Debian2023-11-05T19:08:07Z<p>Dubyk: /* Створення нового правила обігу */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
===== Створення нового правила обігу =====<br />
Наприклад, вибираємо<br />
Підрозділ бібліотеки: Абонемент<br />
Категорія користувача: Студент<br />
Тип одиниці: BOOK<br />
Поточна дозволена кількість видач: 50<br />
Термін випозичання: 14<br />
Одиниці: дні<br />
Продовження (дозволена кількість): 1<br />
<br />
<br />
Встановлення завершено!<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/lib/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc<br />
rm -rf /usr/share/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9211Встановлення Koha з репозитарію на ОС Debian2023-11-05T19:04:07Z<p>Dubyk: /* Створення категорії користувачів */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
Якщо у sql-даних були вибрані типові категорії користувачів, то цей крок Коха пропустить<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
===== Створення нового правила обігу =====<br />
<br />
Встановлення завершено!<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/lib/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc<br />
rm -rf /usr/share/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9210Встановлення Koha з репозитарію на ОС Debian2023-11-05T19:02:35Z<p>Dubyk: /* Адаптаційний етап */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
=====Створення бібліотеки/підрозділу=====<br />
<br />
Створюємо свій підрозділ, напр.<br />
<br />
Код бібліотеки/підрозділу: AB<br />
Найменування: Абонемент<br />
<br />
=====Створення категорії користувачів=====<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
===== Створення нового правила обігу =====<br />
<br />
Встановлення завершено!<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/lib/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc<br />
rm -rf /usr/share/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9209Встановлення Koha з репозитарію на ОС Debian2023-11-05T11:39:02Z<p>Dubyk: /* Кроки веб-встановлювача */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
* Приклади бібліотек/підрозділів<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
===== Створення нового правила обігу =====<br />
<br />
Встановлення завершено!<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/lib/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc<br />
rm -rf /usr/share/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9208Встановлення Koha з репозитарію на ОС Debian2023-11-05T11:38:05Z<p>Dubyk: /* Кроки веб-встановлювача */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
Які типові дані можна вимкнути:<br />
* Приклади користувачів <br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
===== Створення нового правила обігу =====<br />
<br />
Встановлення завершено!<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/lib/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc<br />
rm -rf /usr/share/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9207Встановлення Koha з репозитарію на ОС Debian2023-11-05T11:14:57Z<p>Dubyk: /* Адаптаційний етап */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
<br />
===== Створення адміністратора Коха=====<br />
<br />
Вводимо дані адміністратора Коха - прізвище, ім’я, номер читацького квитка, бібліотека / підрозділ, категорію користувача, логін, пароль.<br />
<br />
===== Створення нового типу одиниць =====<br />
===== Створення нового правила обігу =====<br />
<br />
Встановлення завершено!<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/lib/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc<br />
rm -rf /usr/share/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9206Встановлення Koha з репозитарію на ОС Debian2023-11-05T11:11:42Z<p>Dubyk: /* Кроки веб-встановлювача */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
==== Процес імпорту даних ====<br />
Для імпорту даних Koha використовуватиме дані з теки /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA.<br />
У цій теці будуть як дані, згенеровані самою Коха (у форматі yml-файлів) так і дані sql-скриптів (з набору Сергія Дубика). <br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin) або очищуємо таблиці і перезапускаємо веб-встановлювач. Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
<br />
Для очищення таблиць (ОБЕРЕЖНО - БУДУТЬ ВИТЕРТИ УСІ ДАНІ з БД koha_ukr_unimarc) та перезапуску вею-встановлювача можна використати наступний bash-скрипт delete_all_data_in_db_koha_ukr_unimarc.sh:<br />
<br />
#!/bin/bash <br />
# MySQL сервер та інформація про підключення<br />
MYSQL_USER="koha_ukr_unimarc"<br />
MYSQL_PASSWORD="ваш_пароль"<br />
MYSQL_HOST="localhost" # або інший хост, на якому запущено MySQL<br />
MYSQL_DB="koha_ukr_unimarc" <br />
# Вибір всіх таблиць в базі даних TABLES=$(mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -se "SHOW TABLES")<br />
# Вимкнення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 0;" <br />
# Цикл для виконання DELETE для кожної таблиці<br />
for table in $TABLES<br />
do<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "DELETE FROM $table;"<br />
done <br />
# Включення перевірки зовнішніх ключів<br />
mysql -u"$MYSQL_USER" -p"$MYSQL_PASSWORD" -h "$MYSQL_HOST" "$MYSQL_DB" -e "SET FOREIGN_KEY_CHECKS = 1;"<br />
echo "Всі дані з бази даних $MYSQL_DB були очищені."<br />
sudo /etc/init.d/koha-common restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/mariadb restart<br />
sudo /etc/init.d/memcached restart<br />
koha-plack --restart ukr_unimarc<br />
<br />
Інколи, для кращого очищення, цей скрипт потрібно запускати повторно.<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач (й попередньо очистити таблиці).<br />
<br />
==== Адаптаційний етап ====<br />
<br />
Встановлення завершено!<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/lib/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc<br />
rm -rf /usr/share/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9205Встановлення Koha з репозитарію на ОС Debian2023-11-04T19:13:17Z<p>Dubyk: /* Актуальні українські sql-файли */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
Виконайте наступну команду<br />
sudo find /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA -type d -exec chmod ugo+x {} \;<br />
щоб надати привілеї теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA. Інакше інсталятор її не побачить.<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin). Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
Встановлення завершено!<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач.<br />
<br />
Якщо була така помилка, то скоріш всього sql-дані вставилися в БД частково і веб-встановлювач може видавати помилку на кшталт<br />
<br />
DBIx::Class::Storage::DBI::_dbh_execute(): Duplicate entry '380-55' for key 'PRIMARY' at /usr/share/koha/lib/Koha/SearchField.pm line 38<br />
<br />
У такому випадку необхідно <br />
<br />
1 варіант)<br />
<br />
Очистити БД і наново запустити веб-встановлювач:<br />
mysql -u root -p<br />
DROP DATABASE koha_ukr_unimarc;<br />
DROP USER 'koha_ukr_unimarc'@'localhost';<br />
quit<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/memcached restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
2 варіант) <br />
<br />
Простіший варіант drop-ання усіх таблиць (згадується тут https://www.cyberciti.biz/faq/how-do-i-empty-mysql-database/) а не цілої БД. Тоді не потрібно перевстановлювати екземпляр Koha.<br />
<br />
Через phpmyadmin виділити усі таблиці у БД koha_ukr_unimarc, та вибрати „Знищити“ їх (знімаємо галочуку „Enable foreign key checks“).<br />
<br />
Перед кроками веб-встановлювача перезапускаємо<br />
sudo /etc/init.d/memcached restart<br />
<br />
оскільки може бути помиока<br />
DBIx::Class::Storage::DBI::catch {...} (): DBI Connection failed: Access denied for user 'koha_ukr_unimarc'@'localhost' (using password: YES) at /usr/share/perl5/DBIx/Class/Storage/DBI.pm line 1520. at /usr/share/koha/lib/Koha/Database.pm line 100<br />
(створюється новий пароль для koha_ukr_unimarc і веб-встановлювач може видавати помилку)<br />
<br />
Далі знову проходимо кроки веб-встановлювача.<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/lib/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc<br />
rm -rf /usr/share/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9204Встановлення Koha з репозитарію на ОС Debian2023-11-04T11:11:47Z<p>Dubyk: /* Актуальні українські sql-файли */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' містить оновлення, які необхідно скопіювати у теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin). Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
Встановлення завершено!<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач.<br />
<br />
Якщо була така помилка, то скоріш всього sql-дані вставилися в БД частково і веб-встановлювач може видавати помилку на кшталт<br />
<br />
DBIx::Class::Storage::DBI::_dbh_execute(): Duplicate entry '380-55' for key 'PRIMARY' at /usr/share/koha/lib/Koha/SearchField.pm line 38<br />
<br />
У такому випадку необхідно <br />
<br />
1 варіант)<br />
<br />
Очистити БД і наново запустити веб-встановлювач:<br />
mysql -u root -p<br />
DROP DATABASE koha_ukr_unimarc;<br />
DROP USER 'koha_ukr_unimarc'@'localhost';<br />
quit<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/memcached restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
2 варіант) <br />
<br />
Простіший варіант drop-ання усіх таблиць (згадується тут https://www.cyberciti.biz/faq/how-do-i-empty-mysql-database/) а не цілої БД. Тоді не потрібно перевстановлювати екземпляр Koha.<br />
<br />
Через phpmyadmin виділити усі таблиці у БД koha_ukr_unimarc, та вибрати „Знищити“ їх (знімаємо галочуку „Enable foreign key checks“).<br />
<br />
Перед кроками веб-встановлювача перезапускаємо<br />
sudo /etc/init.d/memcached restart<br />
<br />
оскільки може бути помиока<br />
DBIx::Class::Storage::DBI::catch {...} (): DBI Connection failed: Access denied for user 'koha_ukr_unimarc'@'localhost' (using password: YES) at /usr/share/perl5/DBIx/Class/Storage/DBI.pm line 1520. at /usr/share/koha/lib/Koha/Database.pm line 100<br />
(створюється новий пароль для koha_ukr_unimarc і веб-встановлювач може видавати помилку)<br />
<br />
Далі знову проходимо кроки веб-встановлювача.<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/lib/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc<br />
rm -rf /usr/share/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9203Встановлення Koha з репозитарію на ОС Debian2023-11-04T11:10:23Z<p>Dubyk: /* Актуальні українські sql-файли */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у DrobBox Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' (або у архіві SQL_Koha_23_05_0X_adds/uk-UA_additional.zip) містить оновлення, які необхідно накласти та теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql''' <br />
<br />
(Теку /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA не витираємо, лише дописуємо (копіюємо зі заміною) оновлення з DrobBox).<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin). Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
Встановлення завершено!<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач.<br />
<br />
Якщо була така помилка, то скоріш всього sql-дані вставилися в БД частково і веб-встановлювач може видавати помилку на кшталт<br />
<br />
DBIx::Class::Storage::DBI::_dbh_execute(): Duplicate entry '380-55' for key 'PRIMARY' at /usr/share/koha/lib/Koha/SearchField.pm line 38<br />
<br />
У такому випадку необхідно <br />
<br />
1 варіант)<br />
<br />
Очистити БД і наново запустити веб-встановлювач:<br />
mysql -u root -p<br />
DROP DATABASE koha_ukr_unimarc;<br />
DROP USER 'koha_ukr_unimarc'@'localhost';<br />
quit<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/memcached restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
2 варіант) <br />
<br />
Простіший варіант drop-ання усіх таблиць (згадується тут https://www.cyberciti.biz/faq/how-do-i-empty-mysql-database/) а не цілої БД. Тоді не потрібно перевстановлювати екземпляр Koha.<br />
<br />
Через phpmyadmin виділити усі таблиці у БД koha_ukr_unimarc, та вибрати „Знищити“ їх (знімаємо галочуку „Enable foreign key checks“).<br />
<br />
Перед кроками веб-встановлювача перезапускаємо<br />
sudo /etc/init.d/memcached restart<br />
<br />
оскільки може бути помиока<br />
DBIx::Class::Storage::DBI::catch {...} (): DBI Connection failed: Access denied for user 'koha_ukr_unimarc'@'localhost' (using password: YES) at /usr/share/perl5/DBIx/Class/Storage/DBI.pm line 1520. at /usr/share/koha/lib/Koha/Database.pm line 100<br />
(створюється новий пароль для koha_ukr_unimarc і веб-встановлювач може видавати помилку)<br />
<br />
Далі знову проходимо кроки веб-встановлювача.<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/lib/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc<br />
rm -rf /usr/share/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9202Встановлення Koha з репозитарію на ОС Debian2023-11-02T17:36:59Z<p>Dubyk: /* Утворення локалізованих шаблонів */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у [https://www.dropbox.com/referrals/NTE4MzAyOTY5?src=global9 DrobBox] Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' (або у архіві SQL_Koha_23_05_0X_adds/uk-UA_additional.zip) містить оновлення, які необхідно накласти та теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql''' <br />
<br />
(Теку /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA не витираємо, лише дописуємо (копіюємо зі заміною) оновлення з DrobBox).<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української<!-- та російської --><br />
<br />
sudo koha-translate --install uk-UA<br />
<!-- sudo koha-translate --install ru-RU --><br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
<!-- sudo koha-translate --install be-BY --><br />
sudo koha-translate --install de-DE<br />
sudo koha-translate --install fr-FR<br />
sudo koha-translate --install it-IT<br />
sudo koha-translate --install cs-CZ<br />
sudo koha-translate --install bg-Cyrl<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin). Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
Встановлення завершено!<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач.<br />
<br />
Якщо була така помилка, то скоріш всього sql-дані вставилися в БД частково і веб-встановлювач може видавати помилку на кшталт<br />
<br />
DBIx::Class::Storage::DBI::_dbh_execute(): Duplicate entry '380-55' for key 'PRIMARY' at /usr/share/koha/lib/Koha/SearchField.pm line 38<br />
<br />
У такому випадку необхідно <br />
<br />
1 варіант)<br />
<br />
Очистити БД і наново запустити веб-встановлювач:<br />
mysql -u root -p<br />
DROP DATABASE koha_ukr_unimarc;<br />
DROP USER 'koha_ukr_unimarc'@'localhost';<br />
quit<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/memcached restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
2 варіант) <br />
<br />
Простіший варіант drop-ання усіх таблиць (згадується тут https://www.cyberciti.biz/faq/how-do-i-empty-mysql-database/) а не цілої БД. Тоді не потрібно перевстановлювати екземпляр Koha.<br />
<br />
Через phpmyadmin виділити усі таблиці у БД koha_ukr_unimarc, та вибрати „Знищити“ їх (знімаємо галочуку „Enable foreign key checks“).<br />
<br />
Перед кроками веб-встановлювача перезапускаємо<br />
sudo /etc/init.d/memcached restart<br />
<br />
оскільки може бути помиока<br />
DBIx::Class::Storage::DBI::catch {...} (): DBI Connection failed: Access denied for user 'koha_ukr_unimarc'@'localhost' (using password: YES) at /usr/share/perl5/DBIx/Class/Storage/DBI.pm line 1520. at /usr/share/koha/lib/Koha/Database.pm line 100<br />
(створюється новий пароль для koha_ukr_unimarc і веб-встановлювач може видавати помилку)<br />
<br />
Далі знову проходимо кроки веб-встановлювача.<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/lib/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc<br />
rm -rf /usr/share/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9201Встановлення Koha з репозитарію на ОС Debian2023-11-02T17:16:46Z<p>Dubyk: /* Актуальні українські sql-файли */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у [https://www.dropbox.com/referrals/NTE4MzAyOTY5?src=global9 DrobBox] Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_23_05_0X_adds/uk-UA_additional/uk-UA''' (або у архіві SQL_Koha_23_05_0X_adds/uk-UA_additional.zip) містить оновлення, які необхідно накласти та теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql''' <br />
<br />
(Теку /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA не витираємо, лише дописуємо (копіюємо зі заміною) оновлення з DrobBox).<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української та російської<br />
<br />
sudo koha-translate --install uk-UA<br />
sudo koha-translate --install ru-RU<br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
sudo koha-translate --install be-BY<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin). Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
Встановлення завершено!<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач.<br />
<br />
Якщо була така помилка, то скоріш всього sql-дані вставилися в БД частково і веб-встановлювач може видавати помилку на кшталт<br />
<br />
DBIx::Class::Storage::DBI::_dbh_execute(): Duplicate entry '380-55' for key 'PRIMARY' at /usr/share/koha/lib/Koha/SearchField.pm line 38<br />
<br />
У такому випадку необхідно <br />
<br />
1 варіант)<br />
<br />
Очистити БД і наново запустити веб-встановлювач:<br />
mysql -u root -p<br />
DROP DATABASE koha_ukr_unimarc;<br />
DROP USER 'koha_ukr_unimarc'@'localhost';<br />
quit<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/memcached restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
2 варіант) <br />
<br />
Простіший варіант drop-ання усіх таблиць (згадується тут https://www.cyberciti.biz/faq/how-do-i-empty-mysql-database/) а не цілої БД. Тоді не потрібно перевстановлювати екземпляр Koha.<br />
<br />
Через phpmyadmin виділити усі таблиці у БД koha_ukr_unimarc, та вибрати „Знищити“ їх (знімаємо галочуку „Enable foreign key checks“).<br />
<br />
Перед кроками веб-встановлювача перезапускаємо<br />
sudo /etc/init.d/memcached restart<br />
<br />
оскільки може бути помиока<br />
DBIx::Class::Storage::DBI::catch {...} (): DBI Connection failed: Access denied for user 'koha_ukr_unimarc'@'localhost' (using password: YES) at /usr/share/perl5/DBIx/Class/Storage/DBI.pm line 1520. at /usr/share/koha/lib/Koha/Database.pm line 100<br />
(створюється новий пароль для koha_ukr_unimarc і веб-встановлювач може видавати помилку)<br />
<br />
Далі знову проходимо кроки веб-встановлювача.<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/lib/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc<br />
rm -rf /usr/share/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9200Встановлення Koha з репозитарію на ОС Debian2023-11-02T16:49:22Z<p>Dubyk: /* Підключення репозитарію Koha */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. [https://wiki.koha-community.org/wiki/Koha_on_Debian#The_apt-key_deprecation_warning] та [https://wiki.debian.org/DebianRepository/UseThirdParty])<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у [https://www.dropbox.com/referrals/NTE4MzAyOTY5?src=global9 DrobBox] Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_22_11_0X_adds/uk-UA_additional/uk-UA''' (або у архіві SQL_Koha_22_11_0X_adds/uk-UA_additional.zip) містить оновлення, які необхідно накласти та теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql''' <br />
<br />
(Теку /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA не витираємо, лише дописуємо (копіюємо зі заміною) оновлення з DrobBox).<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української та російської<br />
<br />
sudo koha-translate --install uk-UA<br />
sudo koha-translate --install ru-RU<br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
sudo koha-translate --install be-BY<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin). Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
Встановлення завершено!<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач.<br />
<br />
Якщо була така помилка, то скоріш всього sql-дані вставилися в БД частково і веб-встановлювач може видавати помилку на кшталт<br />
<br />
DBIx::Class::Storage::DBI::_dbh_execute(): Duplicate entry '380-55' for key 'PRIMARY' at /usr/share/koha/lib/Koha/SearchField.pm line 38<br />
<br />
У такому випадку необхідно <br />
<br />
1 варіант)<br />
<br />
Очистити БД і наново запустити веб-встановлювач:<br />
mysql -u root -p<br />
DROP DATABASE koha_ukr_unimarc;<br />
DROP USER 'koha_ukr_unimarc'@'localhost';<br />
quit<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/memcached restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
2 варіант) <br />
<br />
Простіший варіант drop-ання усіх таблиць (згадується тут https://www.cyberciti.biz/faq/how-do-i-empty-mysql-database/) а не цілої БД. Тоді не потрібно перевстановлювати екземпляр Koha.<br />
<br />
Через phpmyadmin виділити усі таблиці у БД koha_ukr_unimarc, та вибрати „Знищити“ їх (знімаємо галочуку „Enable foreign key checks“).<br />
<br />
Перед кроками веб-встановлювача перезапускаємо<br />
sudo /etc/init.d/memcached restart<br />
<br />
оскільки може бути помиока<br />
DBIx::Class::Storage::DBI::catch {...} (): DBI Connection failed: Access denied for user 'koha_ukr_unimarc'@'localhost' (using password: YES) at /usr/share/perl5/DBIx/Class/Storage/DBI.pm line 1520. at /usr/share/koha/lib/Koha/Database.pm line 100<br />
(створюється новий пароль для koha_ukr_unimarc і веб-встановлювач може видавати помилку)<br />
<br />
Далі знову проходимо кроки веб-встановлювача.<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/lib/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc<br />
rm -rf /usr/share/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubykhttp://wiki.koha.org.ua/index.php?title=%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha_%D0%B7_%D1%80%D0%B5%D0%BF%D0%BE%D0%B7%D0%B8%D1%82%D0%B0%D1%80%D1%96%D1%8E_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian&diff=9199Встановлення Koha з репозитарію на ОС Debian2023-11-02T16:45:37Z<p>Dubyk: /* Підключення репозитарію Koha */</p>
<hr />
<div>Розглядається встановлення АБІС Koha версії 21.05.X-23.05.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. <br />
<br />
На даний час це найбільш протестований і розповсюджений варіант.<br />
<br />
Окрім цього ще є варіант [[Встановлення Koha з джерела на ОС Debian|встановлення АБІС Koha з джерельних кодів]], що є дещо більш гнучким щодо налаштування, але і складнішим.<br />
<br />
Див. також<br />
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Debian Koha & Debian] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki<br />
* [https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages Koha on ubuntu - packages] на Koha Wiki<br />
<br />
= Встановлення ОС Debian GNU/Linux <!-- 10 Buster / --> 11 Bullseye =<br />
<br />
Див. також:<br />
* http://download.openlib.org.ua/ustanovka-debian-11/<br />
* https://infoit.com.ua/linux/kak-ustanovit-debian-11-bullseye-shag-za-shagom/<br />
* [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].<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bullseye main non-free contrib<br />
deb-src http://deb.debian.org/debian/ bullseye main non-free contrib<br />
<br />
deb http://security.debian.org/debian-security/ bullseye-security main<br />
deb-src http://security.debian.org/debian-security/ bullseye-security main<br />
<br />
deb http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
deb-src http://deb.debian.org/debian/ bullseye-updates main contrib non-free<br />
<br />
deb http://deb.debian.org/debian bullseye-backports main contrib non-free<br />
deb-src http://deb.debian.org/debian bullseye-backports main<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Встановлення ОС Debian GNU/Linux 12 bookworm =<br />
<br />
Див. також:<br />
* https://d-i.debian.org/manual/uk.amd64/index.html Debian GNU/Linux гайд інсталяції<br />
<br />
Перевірка поточної версії Debian:<br />
lsb_release -d<br />
<br />
Щодо сумісності Коха з іншими версіями ОС див.<br />
* [https://wiki.koha-community.org/wiki/System_requirements_and_recommendations Системні вимоги та рекомендації] (англ.)<br />
<br />
== Підключення гілок non-free та contrib для пакунків Дебіен ==<br />
<br />
Перевіряємо у /etc/apt/sources.list чи підключені гілки non-free та contrib<br />
<br />
sudo mc -e /etc/apt/sources.list<br />
<br />
deb http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-proposed-updates contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian/ bookworm-backports contrib main non-free non-free-firmware<br />
<br />
deb http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
deb-src http://deb.debian.org/debian-security/ bookworm-security contrib main non-free non-free-firmware<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
<br />
= Попередні налаштування =<br />
== Локаль з UTF-8 ==<br />
Перевірка локалі:<br />
sudo locale<br />
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України<br />
<br />
LANG=uk_UA.UTF-8<br />
LANGUAGE=<br />
LC_CTYPE="uk_UA.UTF-8"<br />
LC_NUMERIC="uk_UA.UTF-8"<br />
LC_TIME="uk_UA.UTF-8"<br />
LC_COLLATE="uk_UA.UTF-8"<br />
LC_MONETARY="uk_UA.UTF-8"<br />
LC_MESSAGES="uk_UA.UTF-8"<br />
LC_PAPER="uk_UA.UTF-8"<br />
LC_NAME="uk_UA.UTF-8"<br />
LC_ADDRESS="uk_UA.UTF-8"<br />
LC_TELEPHONE="uk_UA.UTF-8"<br />
LC_MEASUREMENT="uk_UA.UTF-8"<br />
LC_IDENTIFICATION="uk_UA.UTF-8"<br />
<br />
Якщо '''UTF-8''' не згадується, то встановлюємо локаль<br />
apt install locales-all<br />
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"<br />
<br />
== Підключення репозитарію Koha ==<br />
<br />
В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.<br />
<br />
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)<br />
deb http://debian.koha-community.org/koha stable main<br />
(доступні й інші версії (напр. oldstable, oldoldstable…), див. тут http://debian.koha-community.org/koha/dists/)<br />
<br />
Швидко підключити репозитарій Koha можна командою<br />
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також можна вибрати репозитарій з певною версією, напр<br />
echo 'deb http://debian.koha-community.org/koha 21.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 21.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 22.11 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
echo 'deb http://debian.koha-community.org/koha 23.05 main' | sudo tee /etc/apt/sources.list.d/koha.list<br />
<br />
Також додаємо ключ gpg.asc до довірених ключів APT:<br />
apt-get install gnupg2<br />
wget -q -O- https://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
або новіший спосіб<br />
wget -qO - https://debian.koha-community.org/koha/gpg.asc | gpg --dearmor -o /usr/share/keyrings/koha-keyring.gpg<br />
<br />
або ще так (у /etc/apt/sources.list.d/koha.list, див. https://wiki.debian.org/DebianRepository/UseThirdParty)<br />
deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] https://debian.koha-community.org/koha stable main<br />
<br />
Оновлюємо список доступних для встановлення пакунків<br />
sudo apt-get update<br />
<br />
= Встановлення Koha =<br />
<br />
== Встановлення пакунків Koha ==<br />
sudo apt-get install koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Може бути помилка з конфігурацією пакунка 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<br />
<br />
Якщо далі щось піде не так, читаємо стандартну інструкцію про налаштування<br />
<br />
less /usr/share/doc/koha-common/README.Debian<br />
<br />
(у нових версіях можуть бути зміни)<br />
<br />
== Встановлення БД MySQL та допоміжних пакунків ==<br />
<br />
sudo apt-get install mariadb-server <br />
<br />
sudo mysql_secure_installation<br />
<br />
За винятком першого питання, на всі питання можна відповісти Так (“'''Y'''”). Необхідно встановити root пароль (надалі „ПарольАдмінаMySQL“)!<br />
<br />
sudo apt-get install memcached libmemcached-tools<br />
<br />
sudo apt install aptitude<br />
<br />
<!-- sudo aptitude -t buster-backports install php-twig --><br />
<!-- sudo aptitude -t bullseye-backports install php-twig --><br />
sudo apt install php-twig<br />
<br />
sudo apt install phpmyadmin php libapache2-mod-php <br />
<br />
* для „phpmyadmin“ вибрати (пробілом позначити зірочкою) лише „apache2“<br />
* configure database for phpmyadmin with dbconfig-common? — так та встановити пароль застосунку<br />
<br />
Типово phpmyadmin доступний за адресою http://localhost/phpmyadmin<br />
<br />
Якщо потрібен доступ до phpmyadmin на іншому порті, то у файлі /etc/phpmyadmin/phpmyadmin.service змінити<br />
...<br />
<port>8888</port><br />
...<br />
<br />
та додати цей порт у файл /etc/apache2/ports.conf<br />
<br />
Listen 8888<br />
<br />
Перезапуск Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
По умовчанню вхід через phphmyadmin для root закрито.<br />
За потреби можна створити іншого користувача<br />
<br />
mysql -u root -p<br />
CREATE USER 'sysadmin'@'localhost' IDENTIFIED BY 'парольдляsysadmin';<br />
<br />
та надати йому привілеї на усі БД:<br />
<br />
GRANT ALL PRIVILEGES ON *.* TO 'sysadmin'@'localhost' WITH GRANT OPTION;<br />
exit<br />
sudo /etc/init.d/mysql restart<br />
<br />
== Пакунки з CPAN ==<br />
<br />
Пакунки, яких немає у репозитаріях Debian чи Koha, встановлюємо з CPAN.<br />
<br />
Станом на 21.03.2021 необхідні модулі<br />
<br />
* '''HTTPD::Bench::ApacheBench''' (0.73), перевірка в Debian: [https://packages.debian.org/search?keywords=libhttpd-bench-apachebench-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::DBIx::Class''' (0.42), перевірка в Debian: [https://packages.debian.org/search?keywords=libtest-dbix-class-perl&searchon=names&suite=all&section=all]).<br />
* '''Text::CSV::Unicode''' (0.40), перевірка в Debian: [https://packages.debian.org/search?keywords=libtext_csv_unicode-perl&searchon=names&suite=all&section=all]).<br />
* '''Selenium::Remote::Driver''' (1.27), перевірка в Debian: [https://packages.debian.org/search?keywords=libselenium_remote_driver-perl&searchon=names&suite=all&section=all]).<br />
* '''Test::MockModule'''<br />
<br />
<!-- exists in Debian 10: * '''Net::OAuth2::AuthorizationServer''' (0.16), перевірка в Debian: [https://packages.debian.org/search?keywords=libnet_oauth2_authorizationserver-perl&searchon=names&suite=all&section=all]). --><br />
<br />
* Locale::XGettext::TT2<br />
<br />
Встановлюємо командами (при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет) :<br />
<br />
sudo apt-get install make<br />
<br />
sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'<br />
— встановився, вивід —<br />
ADIRAJ/ApacheBench-0.73.tar.gz<br />
make install -- OK<br />
<br />
sudo apt-get install libgdbm-dev apache2-dev libdatetimex-easy-perl <br />
sudo perl -MCPAN -e 'DBIx::Class::Schema::PopulateMore'<br />
sudo perl -MCPAN -e 'install Test::Differences'<br />
sudo perl -MCPAN -e 'install Test::DBIx::Class'<br />
<br />
— встановився, вивід — <br />
NEWELLC/Test-DBIx-Class-0.52.tar.gz<br />
make install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Text::CSV::Unicode'<br />
— встановився, вивід — <br />
RMBARKER/Text-CSV-Unicode-0.400.tar.gz<br />
./Build install -- OK<br />
<br />
sudo perl -MCPAN -e 'install Test::MockModule'<br />
— встановився<br />
<br />
sudo perl -MCPAN -e 'install Selenium::Remote::Driver'<br />
— встановився, вивід — <br />
TEODESIAN/Selenium-Remote-Driver-1.32.tar.gz<br />
/usr/bin/make install -- OK<br />
<br />
<!-- exists in Debian 10: sudo perl -MCPAN -e 'install Net::OAuth2::AuthorizationServer'<br />
— встановився, вивід — <br />
LEEJO/Net-OAuth2-AuthorizationServer-0.23.tar.gz<br />
/usr/bin/make install -- OK<br />
--><br />
<!-- sudo perl -MCPAN -e 'install Readonly::XS'<br />
— встановлено, вивід —<br />
Readonly::XS is up to date (1.05).<br />
''Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командою вище (?).'' --><br />
<br />
<!-- sudo perl -MCPAN -e 'install WebService::ILS'<br />
— встановився, вивід —<br />
SRDJAN/WebService-ILS-0.14.tar.gz<br />
./Build install -- OK--><br />
<br />
sudo perl -MCPAN -e 'install Locale::XGettext::TT2'<br />
<br />
<!--== Налаштування MySQL ==--><br />
<br />
<!--<br />
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL<br />
<br />
Лише, '''якщо пароль не вибрано''' при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином<br />
<br />
sudo dpkg-reconfigure mysql-server-5.5<br />
--><br />
<!--<br />
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне<br />
<br />
[mysqld]<br />
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'<br />
character-set-server=utf8<br />
collation-server=utf8_unicode_ci<br />
character_set_client=utf8<br />
skip-character-set-client-handshake<br />
<br />
3) Перезапускаємо сервер MySQL<br />
<br />
sudo /etc/init.d/mysql restart<br />
<br />
4) Переконуємося, що зміни внесені, виконавши<br />
<br />
sudo mysql -uroot -pПарольАдмінаMySQL<br />
show variables;<br />
quit<br />
--><br />
<br />
== Налаштування Apache та сценарій „koha-post-install-setup“ ==<br />
<br />
1) Виконуємо сценарій<br />
sudo koha-post-install-setup<br />
(він задіює модулі Rewrite та Suexec для Apache)<br />
<br />
2) Додатково задіюємо модулі <!--і Expires, --> Deflate, Cgi, headers, proxy_http<!--, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event<br />
sudo a2enmod expires--><br />
sudo a2enmod deflate<br />
sudo a2enmod rewrite<br />
sudo a2enmod cgi<br />
<!-- sudo a2enmod mpm_itk<br />
sudo a2dismod mpm_event--><br />
sudo a2enmod headers proxy_http<br />
<br />
3) Редагуємо /etc/apache2/conf-available/charset.conf <br />
AddCharset UTF-8 .utf8<br />
AddDefaultCharset UTF-8<br />
<br />
та задіюємо його<br />
<br />
sudo a2enconf charset<br />
<br />
4) Перезапуск Apache<br />
sudo /etc/init.d/apache2 restart<br />
<br />
== Створення екземпляра АБІС Koha ==<br />
<br />
=== Варіанти налаштування АБІС Koha з доменами та портами ===<br />
<br />
==== Варіант з портами 8080 та 8888 (тестовий) ====<br />
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8888" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8888<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з портами 80 та 8080 ====<br />
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.<br />
<br />
===== koha-ukr-unimarc-site.conf =====<br />
/змінюється/<br />
Створюємо файл <br />
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf<br />
наступного змісту<br />
<br />
DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.<br />
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)<br />
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.<br />
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.<br />
INTRAPORT="8080" # TCP listening port for the administration interface<br />
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.<br />
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.<br />
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.<br />
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.<br />
DEFAULTSQL="" # a value is generally not needed.<br />
BIBLIOS_INDEXING_MODE="dom" # Set the indexing mode for bibliographic records. Valid values are dom (default) and grs1.<br />
AUTHORITIES_INDEXING_MODE="dom" # Set the indexing mode for authority records. Valid values are dom (default) and grs1.<br />
USE_MEMCACHED="yes" # Set the instance to make use of memcache.<br />
MEMCACHED_SERVERS="127.0.0.1:11211" # Set a comma-separated list of host:port memcached servers.<br />
MEMCACHED_PREFIX="koha_" # Set the desired prefix for the instance memcached namespace.<br />
ENABLE_SRU="yes" # Enable the Z39.50/SRU server (default: disabled).<br />
SRU_SERVER_PORT="7090" # Specifiy a TCP port number for the Z39.50/SRU server to listen on. (default: 7090).<br />
<br />
===== ports.conf =====<br />
Додаємо<br />
<br />
Listen 8080<br />
Listen 8008<br />
<br />
у файл /etc/apache2/ports.conf<br />
<br />
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.<br />
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок<br />
<br />
<VirtualHost *:8008><br />
<br />
Також перезапускаємо Apache<br />
<br />
sudo /etc/init.d/apache2 restart<br />
<br />
==== Варіант з доменами ====<br />
<br />
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт<br />
<br />
opac.librarydomain.ua<br />
staff.librarydomain.ua<br />
<br />
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha<br />
<br />
=== Команда „koha-create“ ===<br />
<br />
Синтаксис команди для створення екземплярів АБІС 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“:<br />
koha-create [--create-db|--request-db|--populate-db|--use-db] \<br />
[--marcflavor marc21(default)|normarc|unimarc] \<br />
[--zebralang cs|el|en(default)|es|fr|nb|ru|uk] \<br />
[--elasticsearch-server localhost:9200(default)] \<br />
[--auth-idx dom(default)|grs1] \<br />
[--biblio-idx dom (default)|grs1] \<br />
[--use-memcached] \<br />
[--memcached-servers 127.0.0.1:11211,host2:port2,...] \<br />
[--memcached-prefix KOHA|koha_|...] \<br />
[--enable-sru] \<br />
[--sru-port 7090(default)|9998] \<br />
[--defaultsql /path/to/some.sql] \<br />
[--configfile /path/to/config] \<br />
[--passwdfile /path/to/passwd] \<br />
[--dbhost host] \<br />
[--database dbname] \<br />
[--adminuser admin_user_id_in_db] \<br />
[--template-cache-dir /var/cache/koha/<instance>/templates(default)] \<br />
[--timezone time/zone (America/Argentina)] \<br />
[--upload-path /var/lib/koha/<instancename>/uploads(default)|...] \<br />
[--tmp-path dir /var/lib/koha/<instance>/tmp(default)] \<br />
[--letsencrypt] \<br />
[--smtp-host host] \<br />
[--smtp-port NN] \<br />
[--smtp-timeout NN] \<br />
[--smtp-ssl-mode mode [disabled(default)|ssl|starttls] \<br />
[--smtp-user-name user] \<br />
[--smtp-password pass] \<br />
[--smtp-debug] \<br />
[--mb-host localhost)default)] \<br />
[--mb-port NN default: 61613] \<br />
[--mb-user guest(default)] \<br />
[--mb-pass guest(default)] \<br />
[--mb-vhost koha_<instance>(default)] \<br />
[--keep-cookie NAME] \<br />
[--help,-h] \<br />
instancename<br />
<br />
''Зауваження: довжина екземпляра Коха („instancename“) наразі обмежена 11 символами (див. [https://github.com/digibib/kohadevbox/issues/56], [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10205]). Екземпляр з назвою більшої довжини буде непрацездатним.''<br />
<br />
Створення екземпляра АБІС Koha (українська, Unimarc)<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
Вивід:<br />
<br />
Koha instance is empty, no staff user created.<br />
Starting Koha worker daemon for ukr_unimarc (default):.<br />
Starting Koha indexing daemon for ukr_unimarc:.<br />
<br />
== Веб-встановлювач ==<br />
<br />
=== Актуальні українські sql-файли ===<br />
<br />
Частина локалізованих SQL-таблиць '''українською''' була долучена латкою https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=18537 у 2017 р. для версії Koha 17.05.05 та вище.<br />
<br />
Оновлення для українських SQL-таблиць доступні у [https://www.dropbox.com/referrals/NTE4MzAyOTY5?src=global9 DrobBox] Сергія Дубика за адресою:<br />
<br />
'https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0'<br />
<br />
Тека '''SQL_Koha_22_11_0X_adds/uk-UA_additional/uk-UA''' (або у архіві SQL_Koha_22_11_0X_adds/uk-UA_additional.zip) містить оновлення, які необхідно накласти та теку '''uk-UA''' у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql''' <br />
<br />
(Теку /usr/share/koha/intranet/cgi-bin/installer/data/mysql/uk-UA не витираємо, лише дописуємо (копіюємо зі заміною) оновлення з DrobBox).<br />
<br />
=== Утворення локалізованих шаблонів ===<br />
<br />
<!--Переходимо у теку сценаріїв локалізації Коха<br />
<br />
cd /usr/share/koha/misc/translator<br />
<br />
та запускаємо утворення локалізованих шаблонів тощо для кожної мови<br />
<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA<br />
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU<br />
<br />
... і для інших необхідних мов (окрім „en“)<br />
--><br />
<br />
Спочатку дивимося перелік доступних мов<br />
<br />
sudo koha-translate --list --available<br />
<br />
Встановлюємо переклади для української та російської<br />
<br />
sudo koha-translate --install uk-UA<br />
sudo koha-translate --install ru-RU<br />
<br />
та декілька інших<br />
<br />
sudo koha-translate --install pl-PL <br />
sudo koha-translate --install be-BY<br />
…<br />
<br />
=== Кроки веб-встановлювача ===<br />
<br />
Типовий логін для екземляра напр. „unimarc“ буде:<br />
koha_ukr_unimarc<br />
<br />
Пароль можна переглянути за допомогою:<br />
sudo koha-passwd ukr_unimarc<br />
<br />
або логін і пароль зберігаються у файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''', у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди <br />
<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml<br />
<br />
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA (чи http://localhost:8888/?language=uk-UA). Бачимо запит на авторизацію від веб-встановлювача.<br />
<br />
Крок 1: мова '''uk-UA''', перевірка залежностей<br />
<br />
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв<br />
<br />
Крок 3: створення таблиць, вибір МАРК-стандарту '''Unimarc''' (УкрМарк), вибір типових даних (послідовно '''вибираємо усі''' дані, імпорт 5-10 хв.).<br />
<br />
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin). Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com. <br />
<br />
Встановлення завершено!<br />
<br />
==== Помилка „Gateway Timeout“ ====<br />
Рідко, скоріш на повільних серверах, на 3-му кроці може з’являтися помилка „Gateway Timeout“. Спробуйте в налаштуваннях Apache (/etc/apache2/apache2.conf) виставити більший час (Timeout 1200), виконати<br />
sudo /etc/init.d/apache2 restart<br />
<br />
та перезапустити веб-встановлювач.<br />
<br />
Якщо була така помилка, то скоріш всього sql-дані вставилися в БД частково і веб-встановлювач може видавати помилку на кшталт<br />
<br />
DBIx::Class::Storage::DBI::_dbh_execute(): Duplicate entry '380-55' for key 'PRIMARY' at /usr/share/koha/lib/Koha/SearchField.pm line 38<br />
<br />
У такому випадку необхідно <br />
<br />
1 варіант)<br />
<br />
Очистити БД і наново запустити веб-встановлювач:<br />
mysql -u root -p<br />
DROP DATABASE koha_ukr_unimarc;<br />
DROP USER 'koha_ukr_unimarc'@'localhost';<br />
quit<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo /etc/init.d/memcached restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
<br />
sudo koha-create --create-db --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc<br />
<br />
2 варіант) <br />
<br />
Простіший варіант drop-ання усіх таблиць (згадується тут https://www.cyberciti.biz/faq/how-do-i-empty-mysql-database/) а не цілої БД. Тоді не потрібно перевстановлювати екземпляр Koha.<br />
<br />
Через phpmyadmin виділити усі таблиці у БД koha_ukr_unimarc, та вибрати „Знищити“ їх (знімаємо галочуку „Enable foreign key checks“).<br />
<br />
Перед кроками веб-встановлювача перезапускаємо<br />
sudo /etc/init.d/memcached restart<br />
<br />
оскільки може бути помиока<br />
DBIx::Class::Storage::DBI::catch {...} (): DBI Connection failed: Access denied for user 'koha_ukr_unimarc'@'localhost' (using password: YES) at /usr/share/perl5/DBIx/Class/Storage/DBI.pm line 1520. at /usr/share/koha/lib/Koha/Database.pm line 100<br />
(створюється новий пароль для koha_ukr_unimarc і веб-встановлювач може видавати помилку)<br />
<br />
Далі знову проходимо кроки веб-встановлювача.<br />
<br />
== Підтримка кирилиці рушієм пошуку Zebra ==<br />
<br />
Необхідно додати кириличні символи до файлу<br />
<br />
/etc/koha/zebradb/etc/word-phrase-utf.chr<br />
<br />
а саме виправити на наступне:<br />
<br />
lowercase {0-9}{a-z}αβγδεζηθικλμνξοπρστυφχψωæäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’<br />
uppercase {0-9}{A-Z}ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’<br />
<br />
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}<br />
<br />
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.<br />
<br />
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу<br />
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).<br />
<br />
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.<br />
<br />
=== Запуск служби Zebra ===<br />
<br />
sudo koha-zebra --start ukr_unimarc<br />
* koha-zebra — новий скрипт, згадка про нього є тут https://koha-community.org/koha-17-11-released/<br />
<br />
=== Запуск індексації Zebra ===<br />
<br />
sudo koha-rebuild-zebra -f -v ukr_unimarc<br />
<br />
== Включення Plack ==<br />
koha-plack --enable ukr_unimarc; koha-plack --start ukr_unimarc<br />
Щодо продуктивності див. також тут:<br />
* https://wiki.koha-community.org/wiki/Performance<br />
* https://wiki.koha-community.org/wiki/Benchmark_for_16.11<br />
<br />
== E-mail ==<br />
<br />
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:<br />
<br />
sudo koha-email-enable ukr_unimarc<br />
<br />
= Виправлення проблем =<br />
Деколи стає відомо про проблему у поточній версії Koha. Зазвичай виправлення з’являється в наступній версії.<br />
Це у випадку, якщо про проблему повідомлено на [https://bugs.koha-community.org/bugzilla3/ баґгтрекар Koha] і знайдено й прийнято її вирішення (латка) до виходу наступної версії.<br />
Тут згадуватимуться проблеми й їх вирішення для поточних версій Koha.<br />
<!--<br />
== Koha 16.11 ==<br />
=== Поламані посилання при пошуку ===<br />
Проявляється в укр. та рос. локалізації Unimarc (УкрМарк) при використанні відображення Koha-MARC „biblio.biblionumber «» 090^9.<br />
<br />
Вирішення: замінити у файлі /usr/share/koha/intranet/htdocs/intranet-tmpl/prog/en/xslt/UNIMARCslim2intranetResults.xsl<br />
рядок<br />
<xsl:variable name="biblionumber" select="marc:controlfield[@tag=001]"/><br />
на рядок<br />
<xsl:variable name="biblionumber" select="marc:datafield[@tag=090]/marc:subfield[@code='a']"/><br />
<br />
Повідомлення про помилку: [https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=17730 Uniform mapping for biblio.biblionumber (Unimarc) ].<br />
<br />
Потребує оновлення мов<br />
sudo koha-translate --update uk-UA<br />
sudo koha-translate --update pl-PL<br />
sudo koha-translate --update ru-RU<br />
та інших<br />
--><br />
<br />
Див. також: [[Виправлення та вдосконалення для АБІС Koha]], зроблені українською спільнотою АБІС Koha.<br />
<br />
= Оновлення Koha =<br />
<br />
Нова версія Koha виходить кожні шість місяців з набором нових функцій. Також кожен місяць виходять коригувальні оновлення.<br />
<br />
Оновлення проходить легко для варіанту [[Встановлення Koha з репозитарію на ОС Debian|встановлення Koha з пакунків Debian]].<br />
<br />
sudo apt-get update<br />
sudo apt-get upgrade<br />
sudo apt-get install koha-common<br />
<br />
Деколи необхідно оновити ключ debian-сховища Koha.<br />
<br />
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -<br />
<br />
== Встановлення/оновлення допоміжних perl-модулів ==<br />
<br />
Після оновлення, перевіряємо в бібліотечному інтерфейсі сторінку „Домівка > Про АБІС Koha > Модулі Perl“.<br />
<br />
Ви можете побачити відсутні модулі Perl, виділені різними кольорами,<br />
<br />
=== Пакунки з репозитарію Debian ===<br />
<br />
Деякі згадувані тут пакунки могли бути відсутні у репозиторії Debian на момент підготовки пакунки з Koha. Пробуємо знайти відсутні пакунки через пошук <br />
https://www.debian.org/distrib/packages#search_packages<br />
<br />
Знайдені пакунки довстановлюємо<br />
<br />
sudo apt-get install знайдений_пакунок<br />
<br />
=== Пакунки з CPAN ===<br />
<br />
Perl-пакунки, наразі не пакетизовані й відсутні у репозитарії Debian, встановлюємо напряму з репозитарію perl-пакунків CPAN.<br />
<br />
Наприклад, при оновлення до 16.11: <br />
<br />
(perl-пакунок „Test::DBIx::Class“ також вимагав встановлення debian-пакунка „apache2-dev“)<br />
<br />
sudo cpan<br />
install Test::DBIx::Class<br />
install Readonly::XS<br />
install HTTPD::Bench::ApacheBench<br />
<br />
== Оновлення локалізації ==<br />
<br />
sudo koha-translate --update uk-UA<br />
та, за потреби, інших мов (ru-RU, pl-PL, be-BY)<br />
<br />
Однак, при оновленні пакунків Koha локалізація оновлюється автоматично для усіх вибраних мов.<br />
<br />
= Вилучення Koha =<br />
<br />
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно зупинити та вилучити усі екземпляри АБІС Koha командами<br />
<br />
sudo /etc/init.d/mysql restart<br />
sudo /etc/init.d/apache2 restart<br />
sudo koha-zebra --stop ukr_unimarc<br />
sudo koha-indexer --stop ukr_unimarc<br />
sudo koha-plack --stop ukr_unimarc<br />
sudo koha-disable ukr_unimarc<br />
sudo koha-remove ukr_unimarc<br />
sudo userdel ukr_unimarc-koha<br />
sudo groupdel ukr_unimarc-koha<br />
sudo /etc/init.d/memcached restart<br />
<br />
Інколи виникає помилка 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.<br />
<br />
Перегляд переліку наявних екземплярів <br />
<br />
sudo koha-list<br />
<br />
Остаточне вилучення пакунків Koha<br />
<br />
sudo apt-get purge koha-common koha-deps koha-perldeps koha-elasticsearch<br />
<br />
Перевірте також теки:<br />
/var/spool/koha<br />
/var/lib/koha<br />
/usr/share/koha<br />
/etc/koha<br />
<br />
Можна очистити вміст цих тек щодо екземляру ukr_unimarc<br />
rm -rf /var/spool/koha/ukr_unimarc<br />
rm -rf /var/lib/koha/ukr_unimarc<br />
rm -rf /usr/share/koha<br />
<br />
= Налаштування =<br />
<br />
Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].<br />
<br />
= Див. також =<br />
<br />
* [[Встановлення Koha з джерела на ОС Debian]]<br />
* [[Оновлення Koha, встановленої з джерела]]<br />
* [[Коротка інструкція для адміністратора АБІС Koha]]<br />
* [[Короткий посібник користувача АБІС Koha]]<br />
<br />
[[Category:АБІС Koha]]</div>Dubyk