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

(Див. також)
(Встановлення ОС Debian GNU/Linux 8 Jessie)
(Не показано 37 проміжних версій цього користувача)
Рядок 1: Рядок 1:
Розглядається встановлення АБІС Koha серії 3.14.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. Опис, в основному взятий з http://wiki.koha-community.org/wiki/Category:Installation з доповненнями.
+
<b>Наповнення цієї сторінки на цій площадці заморожено! <br />
 +
Подальше редагування відбувається на сайті української спільноти користувачів АБІС Koha [http://koha.org.ua koha.org.ua], зокрема на вікі [http://koha.org.ua/wiki koha.org.ua/wiki]!<br />
 +
Ласкаво просимо!</b>
 +
 
 +
Розглядається встановлення АБІС Koha версії 16.05.05 '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].  
 +
 
 +
Див. також
 +
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
 +
* [http://git.koha-community.org/gitweb/?p=koha.git;a=blob;f=INSTALL.debian;hb=HEAD INSTALL.debian] на Git
 +
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
 +
 
  
 
'''Цей варіант встановлення ще тестується, наразі більш апробованим та універсальним залишається [[Встановлення Koha з джерела на ОС Debian|встановлення з джерельних кодів]].'''
 
'''Цей варіант встановлення ще тестується, наразі більш апробованим та універсальним залишається [[Встановлення Koha з джерела на ОС Debian|встановлення з джерельних кодів]].'''
  
  
= Встановлення ОС Debian GNU/Linux 7 Wheezy =
+
= Встановлення ОС Debian GNU/Linux 9 Stratch =
  
 
Детальніше: [[Встановлення ОС Debian Linux]].
 
Детальніше: [[Встановлення ОС Debian Linux]].
Рядок 32: Рядок 42:
 
   sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"
 
   sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"
  
== Користувач для Koha ==
+
<!--== Користувач для Koha ==
  
 
Додаємо користувача
 
Додаємо користувача
Рядок 50: Рядок 60:
  
 
Після додавання клавіатурним скороченням Ctrl-O зберігаємо файл (/etc/sudoers) та через Ctrl-X виходимо.
 
Після додавання клавіатурним скороченням Ctrl-O зберігаємо файл (/etc/sudoers) та через Ctrl-X виходимо.
 +
-->
 +
 +
<!--== Підключення репозитарію Debian „testing“ та „unstable“ ==
 +
 +
Деякі пакунки (чи оновленні версії) не попали в стабільний випуск Debian, проте можуть бути у випуску „testing“ чи „unstable“.
 +
 +
Створюємо файл /etc/apt/apt.conf і додаємо наступне
 +
 +
# Зробити „wheezy“ дистрибутивом за умовчанням
 +
APT::Default-Release "wheezy";
 +
 +
Створюємо файл /etc/apt/preferences і додаємо наступне (щоб у стабільної гілки „wheezy“ був вищий пріоритет)
 +
 +
Package: *
 +
Pin: release a=stable
 +
Pin-Priority: 700
 +
 +
Package: *
 +
Pin: release a=testing
 +
Pin-Priority: 650
 +
 +
Package: *
 +
Pin: release a=unstable
 +
Pin-Priority: 600
 +
 +
У файл /etc/apt/sources.list додаємо наступне джерело
 +
 +
# Джерело пакунків з гілки Дебіен „testing“
 +
deb http://http.us.debian.org/debian/ testing main contrib non-free.
 +
deb-src http://http.us.debian.org/debian/ testing main contrib non-free.
 +
 +
# Джерело пакунків з гілки Дебіен „testing“ — оновлення безпеки
 +
deb http://security.debian.org/ testing/updates main contrib non-free
 +
deb-src http://security.debian.org/ testing/updates main contrib non-free
 +
 +
# Джерело пакунків з гілки Дебіен „unstable“
 +
deb http://http.us.debian.org/debian/ unstable main contrib non-free.
 +
deb-src http://http.us.debian.org/debian/ unstable main contrib non-free.
 +
 +
Оновлюємо список доступних для встановлення пакунків
 +
 +
sudo apt-get update
 +
-->
  
 
== Підключення репозитарію Koha  ==
 
== Підключення репозитарію Koha  ==
Рядок 56: Рядок 109:
  
 
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)
 
Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)
  deb http://debian.koha-community.org/koha squeeze main
+
  deb http://debian.koha-community.org/koha stable main
чи розробницьку
+
(доступні й інші версії, див. тут http://debian.koha-community.org/koha/dists/)
  deb http://debian.koha-community.org/koha squeeze-dev main
+
 
   
+
Швидко підключити репозитарій Koha можна командою
 +
  echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list
 +
 
 
Також додаємо ключ gpg.asc до довірених ключів APT:
 
Також додаємо ключ gpg.asc до довірених ключів APT:
 
  wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -
 
  wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -
Рядок 75: Рядок 130:
 
та
 
та
  
„'''koha'''“ — подібний пакунок, однак надає один екземпляр Koha. Однак цей варіант ще не керується сценаріями а також необхідно вручну додавати завдання cron та індексування Zebra (див. bug 5071).  
+
„'''koha'''“ — подібний пакунок, однак надає один екземпляр Koha. Однак цей варіант ще не керується сценаріями а також необхідно вручну додавати завдання cron та індексування Zebra (див. [http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=5071 bug 5071].  
  
 
Отож рекомендовано встановлювати пакунок „'''koha-common'''“
 
Отож рекомендовано встановлювати пакунок „'''koha-common'''“
Рядок 106: Рядок 161:
 
* при встановленні „phpmyadmin“ нагадати системі пароль адміна MySQL а також встановити пароль застосунку
 
* при встановленні „phpmyadmin“ нагадати системі пароль адміна MySQL а також встановити пароль застосунку
  
 
+
У файлі /etc/phpmyadmin/phpmyadmin.service змінити порт
/etc/phpmyadmin/phpmyadmin.service  
 
 
 
  ...
 
  ...
 
  <port>8888</port>
 
  <port>8888</port>
 
  ...
 
  ...
  
/etc/apache2/ports.conf
+
та додати цей порт у файл /etc/apache2/ports.conf
  
 
  Listen 8888
 
  Listen 8888
  
/etc/init.d/apache2 restart
+
Перезапуск Apache
 +
 
 +
/etc/init.d/apache2 restart
  
 
== Налаштування MySQL ==
 
== Налаштування MySQL ==
Рядок 144: Рядок 199:
 
(він задіює модулі Rewrite та Suexec для Apache)
 
(він задіює модулі Rewrite та Suexec для Apache)
  
2) Додатково задіюємо модулі Expires та Deflate
+
2) Додатково задіюємо модулі Expires, Deflate, Cgi, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event
 
  sudo a2enmod expires
 
  sudo a2enmod expires
 
  sudo a2enmod deflate
 
  sudo a2enmod deflate
 +
sudo a2enmod cgi
 +
sudo a2enmod mpm_itk
 +
sudo a2dismod mpm_event
  
 
3) Редагуємо  /etc/apache2/conf-available/charset.conf  
 
3) Редагуємо  /etc/apache2/conf-available/charset.conf  
Рядок 152: Рядок 210:
 
  AddDefaultCharset UTF-8
 
  AddDefaultCharset UTF-8
  
ta zadiyuyemo yogo
+
та задіюємо його
  
 
  sudo a2enconf charset
 
  sudo a2enconf charset
Рядок 161: Рядок 219:
 
== Створення екземпляра АБІС Koha ==
 
== Створення екземпляра АБІС Koha ==
  
=== koha-ukr-unimarc-site.conf ===
+
=== Варіанти налаштування АБІС Koha  з доменами та портами ===
 +
 
 +
==== Варіант з портами 8080 та 8888 (тестовий) ====
 +
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.
 +
 
 +
===== koha-ukr-unimarc-site.conf =====
  
 
Створюємо файл  
 
Створюємо файл  
Рядок 167: Рядок 230:
 
наступного змісту
 
наступного змісту
  
  # The domain to append to the instance name, for Apache ServerName. Default is empty. The value must begin with a period.
+
  DOMAIN="localhost"          # Change this to be your domain. Any instance will be a subdomain of this string.
  DOMAIN="localhost"
+
OPACPORT="8080"                # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
 +
OPACPREFIX=""                # For users' interface URL: Prefix to be added to the instance name.
 +
OPACSUFFIX=""                # For users' interface URL: Suffix to be added to the instance name.
 +
INTRAPORT="8888"            # TCP listening port for the administration interface
 +
INTRAPREFIX=""              # For administration interface URL: Prefix to be added to the instance name.
 +
INTRASUFFIX=""              # For administration interface URL: Suffix to be added to the instance name.
 +
ZEBRA_MARC_FORMAT="unimarc"  # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
 +
ZEBRA_LANGUAGE="uk"          # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
 +
DEFAULTSQL=""                # a value is generally not needed.
 +
 
 +
===== ports.conf =====
 +
Додаємо
 +
 
 +
Listen 8080
 +
Listen 8888
 +
 
 +
у файл /etc/apache2/ports.conf
 +
 
 +
Також перезапускаємо Apache
 +
 
 +
  /etc/init.d/apache2 restart
 +
 
 +
==== Варіант з портами 80 та 8080 ====
 +
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.
 
   
 
   
# The port for the OPAC.
+
===== koha-ukr-unimarc-site.conf =====
OPACPORT="80"
+
/змінюється/
+
Створюємо файл
# The port for the intranet. If you set this to empty or 80, then you must also define INTRAPREFIX or INTRASUFFIX.
+
  sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
INTRAPORT="8080"
+
наступного змісту
 
# Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
 
  ZEBRA_MARC_FORMAT="unimarc"
 
 
# Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
 
ZEBRA_LANGUAGE="uk"
 
  
=== ports.conf ===
+
DOMAIN="localhost"          # Change this to be your domain. Any instance will be a subdomain of this string.
 +
OPACPORT="80"                # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
 +
OPACPREFIX=""                # For users' interface URL: Prefix to be added to the instance name.
 +
OPACSUFFIX=""                # For users' interface URL: Suffix to be added to the instance name.
 +
INTRAPORT="8080"            # TCP listening port for the administration interface
 +
INTRAPREFIX=""              # For administration interface URL: Prefix to be added to the instance name.
 +
INTRASUFFIX=""              # For administration interface URL: Suffix to be added to the instance name.
 +
ZEBRA_MARC_FORMAT="unimarc"  # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
 +
ZEBRA_LANGUAGE="uk"          # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
 +
DEFAULTSQL=""                # a value is generally not needed.
  
 +
===== ports.conf =====
 
Додаємо
 
Додаємо
  
Listen 80
 
 
  Listen 8080
 
  Listen 8080
 +
Listen 8008
  
 
у файл /etc/apache2/ports.conf
 
у файл /etc/apache2/ports.conf
 +
 +
Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
 +
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок
 +
 +
<VirtualHost *:8008>
 +
 +
Також перезапускаємо Apache
 +
 +
/etc/init.d/apache2 restart
 +
 +
==== Варіант з доменами ====
 +
 +
Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт
 +
 +
opac.librarydomain.ua
 +
staff.librarydomain.ua
 +
 +
Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha
  
 
=== Команда „koha-create“ ===
 
=== Команда „koha-create“ ===
Синтаксис
+
 
 +
Синтаксис [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create]
 +
 
 
  koha-create [--create-db|--request-db|--populate-db|--use-db] \
 
  koha-create [--create-db|--request-db|--populate-db|--use-db] \
 
   [--marcflavor marc21|normarc|unimarc] \
 
   [--marcflavor marc21|normarc|unimarc] \
Рядок 206: Рядок 316:
 
   --auth-idx dom --biblio-idx dom \
 
   --auth-idx dom --biblio-idx dom \
 
   --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc
 
   --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc
 
'''!!! Для 14.6 версії ця команда дає помилки, які наразі не вдалося виправити... 8-( ''''''
 
 
-----------------------
 
  
 
Вивід:
 
Вивід:
  
 
  Koha instance is empty, no staff user created.
 
  Koha instance is empty, no staff user created.
Enabling site ukr_unimarc.
 
To activate the new configuration, you need to run:
 
  service apache2 reload
 
[ ok ] Restarting web server: apache2 ... waiting .
 
 
  Starting Zebra server for ukr_unimarc
 
  Starting Zebra server for ukr_unimarc
 
<!-- == Bug 9256 в Koha 3.10.0 ==
 
 
[http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=9256 Bug 9256 - debian/templates/koha-conf-site.xml.in is hardcoded to retrieval syntax = usmarc]
 
 
Для виправлення цієї вади рекомендується виконати наступні команди
 
 
sed -i "s/syntax=\"usmarc\"/syntax=\"unimarc\"/" /etc/koha/sites/ukr_unimarc/koha-conf.xml
 
sed -i "s/marc21/unimarc/" /etc/koha/zebradb/etc/usmarc.mar
 
sed -i "s/syntax=\"marc21\"/syntax=\"unimarc\"/" /etc/koha/zebradb/retrieval-info-bib-dom.xml
 
 
sudo /etc/init.d/koha-common restart
 
-->
 
  
 
== Веб-встановлювач ==
 
== Веб-встановлювач ==
Рядок 237: Рядок 326:
 
=== Актуальні українські sql-файли  ===
 
=== Актуальні українські sql-файли  ===
  
У теці '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''
+
Актуальні локалізовані SQL-таблиці (у [https://www.dropbox.com/referrals/NTE4MzAyOTY5?src=global9 DrobBox] Сергія Дубика) '''українською''' знаходяться за адресою:
  
замінюємо теку '''uk-UA'''
+
https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0
  
на '''https://www.dropbox.com/sh/dsdjs5tfvem3pzy/jW3v49NC_q'''
+
Звантажуємо звідси найновішу версію теки '''uk-UA''' та замінюємо нею відповідну теку у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''.
  
(для '''ru-RU''' — відповідно '''https://www.dropbox.com/sh/8hrb00zsp1w1kbt/r3VZz4jcnb''')
+
Примітка: локалізація SQL-таблиць російською '''ru-RU''' доступна лише для версії 3.4.х.
  
 
=== Утворення локалізованих шаблонів ===
 
=== Утворення локалізованих шаблонів ===
  
Переходимо у теку сценаріїв локалізації Коха
+
<!--Переходимо у теку сценаріїв локалізації Коха
  
 
  cd /usr/share/koha/misc/translator
 
  cd /usr/share/koha/misc/translator
Рядок 257: Рядок 346:
  
 
... і для інших необхідних мов (окрім „en“)
 
... і для інших необхідних мов (окрім „en“)
 +
-->
 +
 +
Спочатку дивимося перелік доступних мов
 +
 +
sudo koha-translate --list --available
 +
 +
Встановлюємо переклади для української та російської
 +
 +
sudo koha-translate --install uk-UA
 +
sudo koha-translate --install ru-RU
 +
 +
та декілька інших
 +
 +
sudo koha-translate --install pl-PL
 +
sudo koha-translate --install be-BY
 +
  
 
=== Кроки веб-встановлювача ===
 
=== Кроки веб-встановлювача ===
  
У файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''' у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити пароль можна через команду
+
У файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''' у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди
   
+
 
 +
  sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
 
  sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml
 
  sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml
  
У веб-оглядачі переходимо за адресою http://localhost:8888/?language=uk-UA. Бачимо запит на авторизацію від веб-встановлювача.
+
У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA. Бачимо запит на авторизацію від веб-встановлювача.
  
 
Крок 1: мова uk-UA, перевірка залежностей
 
Крок 1: мова uk-UA, перевірка залежностей
Рядок 276: Рядок 382:
 
Встановлення завершено!.
 
Встановлення завершено!.
  
=== word-phrase-utf.chr ===
+
== Підтримка кирилиці рушієм пошуку Zebra ==
  
У файлі '''/etc/koha/zebradb/etc/word-phrase-utf.chr''' замінюємо
+
Необхідно додати кириличні символи до файлу
  
  lowercase {0-9}{a-z}
+
  /etc/koha/zebradb/etc/word-phrase-utf.chr
uppercase {0-9}{A-Z}
 
  
на
+
а саме виправити на наступне:
  
  lowercase {0-9}{a-z}абвгґдеэєжзіїийклмнопрстуфхцчшщьыъюяёў
+
  lowercase {0-9}{a-z}æäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
  uppercase {0-9}{A-Z}АБВГҐДЕЭЄЖЗІЇИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЮЯЁЎ
+
  uppercase {0-9}{A-Z}ÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’
 +
 +
space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}
  
Наразі без цього пошук видає занадто багато результатів.
+
Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.
 +
 
 +
Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
 +
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).
  
 
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.
 
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.
Рядок 299: Рядок 409:
  
 
  sudo koha-rebuild-zebra -f -v ukr_unimarc
 
  sudo koha-rebuild-zebra -f -v ukr_unimarc
 +
 +
=== E-mail ===
 +
 +
By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:
 +
 +
$ sudo koha-email-enable libraryname
  
 
=== Перевірка пошуку ===
 
=== Перевірка пошуку ===
Рядок 304: Рядок 420:
 
У типових даних є декілька біб-записів й примірників. Перевіряємо пошук за словами
 
У типових даних є декілька біб-записів й примірників. Перевіряємо пошук за словами
  
'''Україна''' (http://localhost:8008/cgi-bin/koha/opac-search.pl?q=Україна)
+
'''Україна''' (http://localhost:80/cgi-bin/koha/opac-search.pl?q=Україна)
  
'''Інвестиції''' (http://localhost:8008/cgi-bin/koha/opac-search.pl?q=Інвестиції)
+
'''Інвестиції''' (http://localhost:80/cgi-bin/koha/opac-search.pl?q=Інвестиції)
  
'''2011''' (http://localhost:8008/cgi-bin/koha/opac-search.pl?q=2011)
+
'''2011''' (http://localhost:80/cgi-bin/koha/opac-search.pl?q=2011)
  
 
== До перевірки ==
 
== До перевірки ==
Рядок 319: Рядок 435:
  
 
= Оновлення Koha =
 
= Оновлення Koha =
 +
 +
Буде додано…
  
 
= Вилучення Koha =
 
= Вилучення Koha =
  
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. Екземпляри АБІС Koha вилучаються за допомогою команди  
+
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно вилучити усі екземпляри АБІС Koha. Екземпляри АБІС Koha вилучаються за допомогою команди  
  
 
  koha-remove ukr_unimarc
 
  koha-remove ukr_unimarc

Версія за 16:41, 20 липня 2017

Наповнення цієї сторінки на цій площадці заморожено!
Подальше редагування відбувається на сайті української спільноти користувачів АБІС Koha koha.org.ua, зокрема на вікі koha.org.ua/wiki!
Ласкаво просимо!

Розглядається встановлення АБІС Koha версії 16.05.05 з репозитарію debian.koha-community.org.

Див. також


Цей варіант встановлення ще тестується, наразі більш апробованим та універсальним залишається встановлення з джерельних кодів.


Зміст

Встановлення ОС Debian GNU/Linux 9 Stratch

Детальніше: Встановлення ОС Debian Linux.

Попередні налаштування

Локаль з UTF-8

Перевірка локалі:

 sudo locale

у виводі повинно бути магічне „UTF-8“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України

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

Якщо UTF-8 не згадується, то встановлюємо локаль

  sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"


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

В репозитарії debian.koha-community.org доступні стабільна та розробницька версії.

Підключаємо у файлі /etc/apt/sources.list стабільну версію (рекомендується)

deb http://debian.koha-community.org/koha stable main

(доступні й інші версії, див. тут http://debian.koha-community.org/koha/dists/)

Швидко підключити репозитарій Koha можна командою

echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Також додаємо ключ gpg.asc до довірених ключів APT:

wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

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

apt-get update

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

Встановлення пакунка „koha-common“

Доступні два пакунки, що встановлюють АБІС Koha, це

koha-common“ — містить увесь код та допоміжні сценарії. Цей пакунок після встановлення не надає налаштованого та працюючого екземпляру Koha, однак доступна команда „koha-create“ та інші корисні інструменти, що дозволять Вам створити скільки завгодно налаштованих та працюючих екземплярів (включаючи завдання cron та індексацію Zebra).

та

koha“ — подібний пакунок, однак надає один екземпляр Koha. Однак цей варіант ще не керується сценаріями а також необхідно вручну додавати завдання cron та індексування Zebra (див. bug 5071.

Отож рекомендовано встановлювати пакунок „koha-common

apt-get install koha-common 

При цьому може з’явитися вивід повідомлень Debconf, напр.

If you are upgrading from a Koha 3.2 to 3.4 release, you must run:
 sudo /usr/sbin/koha-upgrade-to-3.4
For large catalogues, running this may take a while. Your Koha installation should be largely operational during the process, but some things,
 particularly to do with items, may appear strange until the upgrade and re-index is complete.

Читаємо та слідуємо вказівкам.

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

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

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

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

sudo apt-get install \
mysql-server \
phpmyadmin
  • при встановленні сервера MySQL вказуємо пароль адміністратора (користувач „root“), надалі „ПарольАдмінаMySQL“
  • для „phpmyadmin“ вибрати лише „apache2“
  • при встановленні „phpmyadmin“ нагадати системі пароль адміна MySQL а також встановити пароль застосунку

У файлі /etc/phpmyadmin/phpmyadmin.service змінити порт

...
<port>8888</port>
...

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

Listen 8888

Перезапуск Apache

/etc/init.d/apache2 restart

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

1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL Якщо пароль не вибрано при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином

sudo dpkg-reconfigure mysql-server-5.5

2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне

[mysqld]
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'
character-set-server=utf8
collation-server=utf8_unicode_ci
character_set_client=utf8
skip-character-set-client-handshake

3) Перезапускаємо сервер MySQL

sudo /etc/init.d/mysql restart

4) Переконуємося, що зміни внесені, виконавши

sudo mysql -uroot -pПарольАдмінаMySQL
show variables;
quit

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

1) Виконуємо сценарій

sudo koha-post-install-setup

(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі Expires, Deflate, Cgi, Mpm_Itk та виключаємо[1] модуль Event

sudo a2enmod expires
sudo a2enmod deflate
sudo a2enmod cgi
sudo a2enmod mpm_itk
sudo a2dismod mpm_event

3) Редагуємо /etc/apache2/conf-available/charset.conf

AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

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

sudo a2enconf charset

4) Перезапуск Apache

sudo /etc/init.d/apache2 restart

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

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

Варіант з портами 8080 та 8888 (тестовий)

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

koha-ukr-unimarc-site.conf

Створюємо файл

sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf

наступного змісту

DOMAIN="localhost"           # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080"                # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX=""                # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX=""                # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888"             # TCP listening port for the administration interface
INTRAPREFIX=""               # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX=""               # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc"  # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk"          # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL=""                # a value is generally not needed.
ports.conf

Додаємо

Listen 8080
Listen 8888

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

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

/etc/init.d/apache2 restart

Варіант з портами 80 та 8080

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

koha-ukr-unimarc-site.conf

/змінюється/ Створюємо файл

sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf

наступного змісту

DOMAIN="localhost"           # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80"                # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX=""                # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX=""                # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080"             # TCP listening port for the administration interface
INTRAPREFIX=""               # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX=""               # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc"  # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk"          # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL=""                # a value is generally not needed.
ports.conf

Додаємо

Listen 8080
Listen 8008

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

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

<VirtualHost *:8008>

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

/etc/init.d/apache2 restart

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

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

opac.librarydomain.ua
staff.librarydomain.ua

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

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

Синтаксис [2]

koha-create [--create-db|--request-db|--populate-db|--use-db] \
  [--marcflavor marc21|normarc|unimarc] \
  [--zebralang en|es|fr|nb|ru|uk] \
  [--defaultsql /path/to/some.sql] \
  [--configfile /path/to/config] [--passwdfile /path/to/passwd] \
  [--database database] [--adminuser n] instancename


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

sudo koha-create --create-db --marcflavor unimarc --zebralang uk \
 --auth-idx dom --biblio-idx dom \
 --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc

Вивід:

Koha instance is empty, no staff user created.
Starting Zebra server for ukr_unimarc

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

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

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

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

Звантажуємо звідси найновішу версію теки uk-UA та замінюємо нею відповідну теку у /usr/share/koha/intranet/cgi-bin/installer/data/mysql.

Примітка: локалізація SQL-таблиць російською ru-RU доступна лише для версії 3.4.х.

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

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

sudo koha-translate --list --available

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

sudo koha-translate --install uk-UA
sudo koha-translate --install ru-RU

та декілька інших

sudo koha-translate --install pl-PL 
sudo koha-translate --install be-BY
…

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

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

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

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

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

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

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

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

Встановлення завершено!.

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

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

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

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

lowercase {0-9}{a-z}æäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

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

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

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

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

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

sudo koha-start-zebra ukr_unimarc

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

sudo koha-rebuild-zebra -f -v ukr_unimarc

E-mail

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

$ sudo koha-email-enable libraryname

Перевірка пошуку

У типових даних є декілька біб-записів й примірників. Перевіряємо пошук за словами

Україна (http://localhost:80/cgi-bin/koha/opac-search.pl?q=Україна)

Інвестиції (http://localhost:80/cgi-bin/koha/opac-search.pl?q=Інвестиції)

2011 (http://localhost:80/cgi-bin/koha/opac-search.pl?q=2011)

До перевірки

  • що додано у завдання cron?
  • переіндесація автоматична чи по розкладу і чи взагалі робиться?
  • як задіяти ICU? (Зауваження щодо ICU див. тут)
  • чи можна обійтися без правки word-phrase-utf.chr?
  • пошук за „Інвестиції“ мав дати 4 результати..?

Оновлення Koha

Буде додано…

Вилучення Koha

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

koha-remove ukr_unimarc

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

koha-list

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

apt-get purge koha koha-common

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

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

Див. також