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

м (Вилучення Koha)
 
(Не показано 56 проміжних версій цього користувача)
Рядок 1: Рядок 1:
Розглядається встановлення АБІС Koha серії 3.10 '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. Опис, в основному взятий з http://wiki.koha-community.org/wiki/Category:Installation з доповненнями.
+
<b>Наповнення цієї сторінки на цій площадці заморожено! <br />
 +
Подальше редагування відбувається на сайті української спільноти користувачів АБІС Koha [http://wiki.koha.org.ua wiki.koha.org.ua]!<br />
 +
Ласкаво просимо!</b>
 +
 
 +
Розглядається встановлення АБІС Koha версії 16.05.05 '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].  
 +
 
 +
Див. також
 +
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
 +
* [http://git.koha-community.org/gitweb/?p=koha.git;a=blob;f=INSTALL.debian;hb=HEAD INSTALL.debian] на Git
 +
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki
 +
 
  
 
'''Цей варіант встановлення ще тестується, наразі більш апробованим та універсальним залишається [[Встановлення Koha з джерела на ОС Debian|встановлення з джерельних кодів]].'''
 
'''Цей варіант встановлення ще тестується, наразі більш апробованим та універсальним залишається [[Встановлення Koha з джерела на ОС Debian|встановлення з джерельних кодів]].'''
  
  
= Встановлення ОС Debian GNU/Linux 6 Squeeze =
+
= Встановлення ОС 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'''“
Рядок 93: Рядок 148:
  
 
  less /usr/share/doc/koha-common/README.Debian
 
  less /usr/share/doc/koha-common/README.Debian
 +
 +
Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865
  
 
== Встановлення БД MySQL та допоміжних пакунків ==
 
== Встановлення БД MySQL та допоміжних пакунків ==
Рядок 103: Рядок 160:
 
* для „phpmyadmin“ вибрати лише „apache2“
 
* для „phpmyadmin“ вибрати лише „apache2“
 
* при встановленні „phpmyadmin“ нагадати системі пароль адміна MySQL а також встановити пароль застосунку
 
* при встановленні „phpmyadmin“ нагадати системі пароль адміна MySQL а також встановити пароль застосунку
 +
 +
У файлі /etc/phpmyadmin/phpmyadmin.service змінити порт
 +
...
 +
<port>8888</port>
 +
...
 +
 +
та додати цей порт у файл /etc/apache2/ports.conf
 +
 +
Listen 8888
 +
 +
Перезапуск Apache
 +
 +
/etc/init.d/apache2 restart
  
 
== Налаштування MySQL ==
 
== Налаштування MySQL ==
Рядок 108: Рядок 178:
 
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL
 
1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL
 
Якщо пароль не вибрано при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином
 
Якщо пароль не вибрано при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином
  sudo dpkg-reconfigure mysql-server-5.1
+
  sudo dpkg-reconfigure mysql-server-5.5
 
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне
 
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне
 
  [mysqld]
 
  [mysqld]
Рядок 129: Рядок 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.d/charset
+
3) Редагуємо /etc/apache2/conf-available/charset.conf
 
  AddCharset UTF-8 .utf8
 
  AddCharset UTF-8 .utf8
 
  AddDefaultCharset UTF-8
 
  AddDefaultCharset UTF-8
 +
 +
та задіюємо його
 +
 +
sudo a2enconf charset
  
 
4) Перезапуск Apache
 
4) Перезапуск Apache
Рядок 142: Рядок 219:
 
== Створення екземпляра АБІС Koha ==
 
== Створення екземпляра АБІС Koha ==
  
=== koha-ukr-unimarc-site.conf ===
+
=== Варіанти налаштування АБІС Koha  з доменами та портами ===
 +
 
 +
==== Варіант з портами 8080 та 8888 (тестовий) ====
 +
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.
 +
 
 +
===== koha-ukr-unimarc-site.conf =====
  
 
Створюємо файл  
 
Створюємо файл  
Рядок 148: Рядок 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="8008"
+
/змінюється/
+
Створюємо файл
# 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="8888"
+
наступного змісту
 
# 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 8080
 
  Listen 8008
 
  Listen 8008
Listen 8888
 
  
 
у файл /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“ ===
Синтаксис
+
 
  koha-create {--create-db|--request-db|--populate-db|--use-db} [--marcflavor marc21|normarc|unimarc] [--zebralang en|nb|fr]
+
Синтаксис [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create]
            [--defaultsql /path/to/some.sql] [--configfile /path/to/config] [--passwdfile /path/to/passwd] [--database database]
+
 
            [--adminuser n] {instancename}
+
  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)
 
Створення екземпляра АБІС Koha (українська, Unimarc)
  
  sudo koha-create --create-db --marcflavor unimarc --configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_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.
 
  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
 
  
 
== Веб-встановлювач ==
 
== Веб-встановлювач ==
Рядок 207: Рядок 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
Рядок 227: Рядок 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, перевірка залежностей
Рядок 246: Рядок 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“ також потрібно вносити ці зміни.
Рядок 269: Рядок 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
  
 
=== Перевірка пошуку ===
 
=== Перевірка пошуку ===
Рядок 274: Рядок 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)
  
 
== До перевірки ==
 
== До перевірки ==
Рядок 289: Рядок 435:
  
 
= Оновлення Koha =
 
= Оновлення Koha =
 +
 +
Буде додано…
  
 
= Вилучення Koha =
 
= Вилучення Koha =
  
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. Екземпляри АБІС Koha вилучаються за допомогою команди  
+
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно вилучити усі екземпляри АБІС Koha. Екземпляри АБІС Koha вилучаються за допомогою команди  
  
 
  koha-remove ukr_unimarc
 
  koha-remove ukr_unimarc
Рядок 313: Рядок 461:
 
* [[Оновлення Koha, встановленої з джерела]]
 
* [[Оновлення Koha, встановленої з джерела]]
 
* [[Вилучення Koha, встановленої з джерела]]
 
* [[Вилучення Koha, встановленої з джерела]]
 +
* [[Коротка інструкція для адміністратора АБІС Koha]]
 +
* [[Короткий посібник користувача АБІС Koha]]
  
 
[[Категорія:АБІС Koha]]
 
[[Категорія:АБІС Koha]]
 
[[Категорія:Бібліотека]]
 
[[Категорія:Бібліотека]]

Поточна версія на 20:05, 1 листопада 2023

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

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

Див. також


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


Зміст

Встановлення ОС 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, встановленої з джерела.

Див. також