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

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

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

Див. також

Koha_on_Debian на Koha Wiki
INSTALL.debian на Git
Category:Installation на Koha Wiki

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

Зміст

1 Встановлення ОС Debian GNU/Linux 9 Stratch
2 Попередні налаштування
- 2.1 Локаль з UTF-8
- 2.2 Підключення репозитарію Koha
3 Встановлення Koha
4 Оновлення Koha
5 Вилучення Koha
6 Налаштування
7 Див. також

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

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

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

Локаль з UTF-8

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

 sudo locale

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

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

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

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

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

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

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

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

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

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

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

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

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

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

apt-get update

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

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

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

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

та

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

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

apt-get install koha-common

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

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

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

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

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

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

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

sudo apt-get install \
mysql-server \
phpmyadmin

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

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

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

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

Listen 8888

Перезапуск Apache

/etc/init.d/apache2 restart

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

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

sudo dpkg-reconfigure mysql-server-5.5

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

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

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

sudo /etc/init.d/mysql restart

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

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

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

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

sudo koha-post-install-setup

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

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

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

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

AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

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

sudo a2enconf charset

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

sudo /etc/init.d/apache2 restart

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

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

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

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

koha-ukr-unimarc-site.conf

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

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

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

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

ports.conf

Додаємо

Listen 8080
Listen 8888

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

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

/etc/init.d/apache2 restart

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

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

koha-ukr-unimarc-site.conf

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

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

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

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

ports.conf

Додаємо

Listen 8080
Listen 8008

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

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

<VirtualHost *:8008>

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

/etc/init.d/apache2 restart

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

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

opac.librarydomain.ua
staff.librarydomain.ua

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

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

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

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

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

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

Вивід:

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

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

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

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

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

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

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

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

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

sudo koha-translate --list --available

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

sudo koha-start-zebra ukr_unimarc

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

sudo koha-rebuild-zebra -f -v ukr_unimarc

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

Див. також

@@ Рядок 1: / Рядок 1: @@
-Розглядається встановлення АБІС Koha серії 3.6 '''з репозитарію''' [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|встановлення з джерельних кодів]].'''
-= Встановлення ОС Debian GNU/Linux 6 Squeeze =
+= Встановлення ОС Debian GNU/Linux 9 Stratch =
 Детальніше: [[Встановлення ОС Debian Linux]].
@@ Рядок 32: / Рядок 42: @@
     sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"
-== Користувач для Koha ==
+<!--== Користувач для Koha ==
 Додаємо користувача
@@ Рядок 50: / Рядок 60: @@
 Після додавання клавіатурним скороченням 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  ==
@@ Рядок 56: / Рядок 109: @@
 Підключаємо у файлі '''/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:
   wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -
-Оновлюмо список доступних для встановлення пакунків
+Оновлюємо список доступних для встановлення пакунків
   apt-get update
@@ Рядок 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'''“
@@ Рядок 93: / Рядок 148: @@
   less /usr/share/doc/koha-common/README.Debian
+Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865
 == Встановлення БД MySQL та допоміжних пакунків ==
@@ Рядок 103: / Рядок 160: @@
 * для „phpmyadmin“ вибрати лише „apache2“
 * при встановленні „phpmyadmin“ нагадати системі пароль адміна MySQL а також встановити пароль застосунку
+У файлі /etc/phpmyadmin/phpmyadmin.service змінити порт
+ ...
+ <port>8888</port>
+ ...
+та додати цей порт у файл /etc/apache2/ports.conf
+ Listen 8888
+Перезапуск Apache
+ /etc/init.d/apache2 restart
 == Налаштування MySQL ==
@@ Рядок 108: / Рядок 178: @@
 ) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL
 Якщо пароль не вибрано при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином
-  sudo dpkg-reconfigure mysql-server-5.1
+  sudo dpkg-reconfigure mysql-server-5.5
 ) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне
- [client]
- default-character-set=utf8
- [mysqld_safe]
- default-character-set=utf8
- [mysql]
- default-character-set=utf8
   [mysqld]
   init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'
- default-character-set=utf8
   character-set-server=utf8
   collation-server=utf8_unicode_ci
   character_set_client=utf8
- default-collation=utf8_unicode_ci
   skip-character-set-client-handshake
 ) Перезапускаємо сервер MySQL
@@ Рядок 137: / Рядок 199: @@
 (він задіює модулі Rewrite та Suexec для Apache)
-) Додатково задіюємо модулі Expires та Deflate
+) Додатково задіюємо модулі 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 deflate
+ sudo a2enmod cgi
+ sudo a2enmod mpm_itk
+ sudo a2dismod mpm_event
-) Редагуємо /etc/apache2/conf.d/charset
+) Редагуємо  /etc/apache2/conf-available/charset.conf
   AddCharset UTF-8 .utf8
   AddDefaultCharset UTF-8
+та задіюємо його
+ sudo a2enconf charset
 ) Перезапуск Apache
@@ Рядок 150: / Рядок 219: @@
 == Створення екземпляра АБІС Koha ==
-=== koha-ukr-unimarc-site.conf ===
+=== Варіанти налаштування АБІС Koha  з доменами та портами ===
+==== Варіант з портами 8080 та 8888 (тестовий) ====
+Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.
+===== koha-ukr-unimarc-site.conf =====
 Створюємо файл
-  mc -e /etc/koha/koha-ukr-unimarc-site.conf
+  sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
 наступного змісту
-  # 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 8888
 у файл /etc/apache2/ports.conf
-=== sort-string-utf.chr ===
+Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
-Створюємо файл '''/etc/koha/zebradb/lang_defs/uk/sort-string-utf.chr''' наступного змісту
+Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок
+ <VirtualHost *:8008>
+Також перезапускаємо Apache
-  # Generic character map.
+  /etc/init.d/apache2 restart
- #
+==== Варіант з доменами ====
- encoding utf-8
+Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт
-  # Define the basic value-set. *Beware* of changing this without re-indexing
-  # your databases.
+  opac.librarydomain.ua
- lowercase {0-9}{a-z}абвгґдеэєжзіїийклмнопрстуфхцчшщьыъюяёў
+  staff.librarydomain.ua
- uppercase {0-9}{A-Z}АБВГҐДЕЭЄЖЗІЇИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЮЯЁЎ
+Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha
- # Breaking characters
- space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}
- # Characters to be considered equivalent for searching purposes.
- equivalent ґ(г)
- equivalent ё(е)
- equivalent ъ(ь)
- # Supplemental mappings
- map (^En\s)    @
- map (^Den\s)    @
 === Команда „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-create --create-db --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.
- 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
@@ Рядок 230: / Рядок 326: @@
 === Актуальні українські 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
@@ Рядок 250: / Рядок 346: @@
 ... і для інших необхідних мов (окрім „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
-У веб-оглядачі переходимо за адресою http://localhost:8888/?language=uk-UA. Бачимо запит на авторизацію від веб-встановлювача.
+У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA. Бачимо запит на авторизацію від веб-встановлювача.
 Крок 1: мова uk-UA, перевірка залежностей
@@ Рядок 261: / Рядок 376: @@
 Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв
-Крок 3: створення таблиць, вибір МАРК-стандарту ('''Unimarc'''), вибір типових даних (вибираємо усе, окрім ''unimarc_bibliographic_DEFAULT_local_952_obsolete'')
+Крок 3: створення таблиць, вибір МАРК-стандарту ('''Unimarc'''), вибір типових даних.
-На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin).
+На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin). Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.
 Встановлення завершено!.
-=== 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“ також потрібно вносити ці зміни.
 === Запуск служби Zebra ===
@@ Рядок 285: / Рядок 408: @@
 === Запуск індексації Zebra ===
-  sudo koha-rebuild-zebra -f 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
 === Перевірка пошуку ===
@@ Рядок 291: / Рядок 420: @@
 У типових даних є декілька біб-записів й примірників. Перевіряємо пошук за словами
- Україна
+'''Україна''' (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)
 == До перевірки ==
@@ Рядок 303: / Рядок 435: @@
 = Оновлення Koha =
+Буде додано…
 = Вилучення Koha =
-Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення экземплярів АБІС Koha. Экземпляри АБІС Koha вилучаються за допомогою команди
+Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно вилучити усі екземпляри АБІС Koha. Екземпляри АБІС Koha вилучаються за допомогою команди
   koha-remove ukr_unimarc
+Перегляд переліку наявних екземплярів
+ koha-list
+Остаточне вилучення пакунків Koha
+ apt-get purge koha koha-common
+= Налаштування =
+Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].
 = Див. також =
@@ Рядок 314: / Рядок 461: @@
 * [[Оновлення Koha, встановленої з джерела]]
 * [[Вилучення Koha, встановленої з джерела]]
+* [[Коротка інструкція для адміністратора АБІС Koha]]
+* [[Короткий посібник користувача АБІС Koha]]
 [[Категорія:АБІС Koha]]
 [[Категорія:Бібліотека]]

Анонім

Пошук

Навігація

Вікі-інструменти

Інструменти сторінки

Категорії

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

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

Зміст

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

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

Локаль з UTF-8

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

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

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

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

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

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

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

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

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

koha-ukr-unimarc-site.conf

ports.conf

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

koha-ukr-unimarc-site.conf

ports.conf

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

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

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

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

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

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

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

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

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

E-mail

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

До перевірки

Оновлення Koha

Вилучення Koha

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

Див. також