Відмінності між версіями «Встановлення Koha з репозитарію на ОС Debian»
Dubyk (обговорення • внесок) (→Налаштування MySQL) |
Dubyk (обговорення • внесок) |
||
Рядок 1: | Рядок 1: | ||
− | Розглядається встановлення АБІС Koha серії 3. | + | Розглядається встановлення АБІС Koha серії 3.14.X '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org]. Опис, в основному взятий з http://wiki.koha-community.org/wiki/Category:Installation з доповненнями. |
'''Цей варіант встановлення ще тестується, наразі більш апробованим та універсальним залишається [[Встановлення Koha з джерела на ОС Debian|встановлення з джерельних кодів]].''' | '''Цей варіант встановлення ще тестується, наразі більш апробованим та універсальним залишається [[Встановлення Koha з джерела на ОС Debian|встановлення з джерельних кодів]].''' |
Версія за 21:24, 23 листопада 2013
Розглядається встановлення АБІС Koha серії 3.14.X з репозитарію debian.koha-community.org. Опис, в основному взятий з http://wiki.koha-community.org/wiki/Category:Installation з доповненнями.
Цей варіант встановлення ще тестується, наразі більш апробованим та універсальним залишається встановлення з джерельних кодів.
Зміст
- 1 Встановлення ОС Debian GNU/Linux 6 Squeeze
- 2 Попередні налаштування
- 3 Встановлення Koha
- 4 Оновлення Koha
- 5 Вилучення Koha
- 6 Налаштування
- 7 Див. також
Встановлення ОС Debian GNU/Linux 6 Squeeze
Детальніше: Встановлення ОС 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
Додаємо користувача
(нижче замість „АдміністраторСистемиKoha“ вводимо своє)
sudo adduser АдміністраторСистемиKoha
Деколи група автоматично не створюється — тоді потрібно ще
sudo addgroup АдміністраторСистемиKoha sudo adduser АдміністраторСистемиKoha АдміністраторСистемиKoha
Командою „sudo visudo“ відкриваємо для редагування файл привілеїв адміністратора і надаємо їх користувачу АдміністраторСистемиKoha, додавши у кінці файлу рядок
АдміністраторСистемиKoha ALL=(ALL) ALL
Після додавання клавіатурним скороченням Ctrl-O зберігаємо файл (/etc/sudoers) та через Ctrl-X виходимо.
Підключення репозитарію Koha
В репозитарії debian.koha-community.org доступні стабільна та розробницька версії.
Підключаємо у файлі /etc/apt/sources.list стабільну версію (рекомендується)
deb http://debian.koha-community.org/koha squeeze main
чи розробницьку
deb http://debian.koha-community.org/koha squeeze-dev main
Також додаємо ключ 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
Встановлення БД MySQL та допоміжних пакунків
sudo apt-get install \ mysql-server \ phpmyadmin
- при встановленні сервера MySQL вказуємо пароль адміністратора (користувач „root“), надалі „ПарольАдмінаMySQL“
- для „phpmyadmin“ вибрати лише „apache2“
- при встановленні „phpmyadmin“ нагадати системі пароль адміна MySQL а також встановити пароль застосунку
Налаштування 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
sudo a2enmod expires sudo a2enmod deflate
3) Редагуємо /etc/apache2/conf.d/charset
AddCharset UTF-8 .utf8 AddDefaultCharset UTF-8
4) Перезапуск Apache
sudo /etc/init.d/apache2 restart
Створення екземпляра АБІС 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" # The port for the OPAC. OPACPORT="8008" # The port for the intranet. If you set this to empty or 80, then you must also define INTRAPREFIX or INTRASUFFIX. 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
Додаємо
Listen 8008 Listen 8888
у файл /etc/apache2/ports.conf
Команда „koha-create“
Синтаксис
koha-create {--create-db|--request-db|--populate-db|--use-db} [--marcflavor marc21|normarc|unimarc] [--zebralang en|nb|fr] [--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 --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
Bug 9256 в Koha 3.10.0
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
Веб-встановлювач
Актуальні українські sql-файли
У теці /usr/share/koha/intranet/cgi-bin/installer/data/mysql
замінюємо теку uk-UA
на https://www.dropbox.com/sh/dsdjs5tfvem3pzy/jW3v49NC_q
(для ru-RU — відповідно https://www.dropbox.com/sh/8hrb00zsp1w1kbt/r3VZz4jcnb)
Утворення локалізованих шаблонів
Переходимо у теку сценаріїв локалізації Коха
cd /usr/share/koha/misc/translator
та запускаємо утворення локалізованих шаблонів тощо для кожної мови
sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install uk-UA sudo env KOHA_CONF=/etc/koha/sites/ukr_unimarc/koha-conf.xml PERL5LIB=/usr/share/koha/lib perl -I /usr/share/koha/lib "./translate" install ru-RU
... і для інших необхідних мов (окрім „en“)
Кроки веб-встановлювача
У файлі /etc/koha/sites/ukr_unimarc/koha-conf.xml у розділі config знаходимо користувача (user) та пароль (pass). Також побачити пароль можна через команду
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml
У веб-оглядачі переходимо за адресою http://localhost:8888/?language=uk-UA. Бачимо запит на авторизацію від веб-встановлювача.
Крок 1: мова uk-UA, перевірка залежностей
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв
Крок 3: створення таблиць, вибір МАРК-стандарту (Unimarc), вибір типових даних.
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin). Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.
Встановлення завершено!.
word-phrase-utf.chr
У файлі /etc/koha/zebradb/etc/word-phrase-utf.chr замінюємо
lowercase {0-9}{a-z} uppercase {0-9}{A-Z}
на
lowercase {0-9}{a-z}абвгґдеэєжзіїийклмнопрстуфхцчшщьыъюяёў uppercase {0-9}{A-Z}АБВГҐДЕЭЄЖЗІЇИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЮЯЁЎ
Наразі без цього пошук видає занадто багато результатів.
При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.
Запуск служби Zebra
sudo koha-start-zebra ukr_unimarc
Запуск індексації Zebra
sudo koha-rebuild-zebra -f -v ukr_unimarc
Перевірка пошуку
У типових даних є декілька біб-записів й примірників. Перевіряємо пошук за словами
Україна (http://localhost:8008/cgi-bin/koha/opac-search.pl?q=Україна)
Інвестиції (http://localhost:8008/cgi-bin/koha/opac-search.pl?q=Інвестиції)
2011 (http://localhost:8008/cgi-bin/koha/opac-search.pl?q=2011)
До перевірки
- що додано у завдання cron?
- переіндесація автоматична чи по розкладу і чи взагалі робиться?
- як задіяти ICU? (Зауваження щодо ICU див. тут)
- чи можна обійтися без правки word-phrase-utf.chr?
- пошук за „Інвестиції“ мав дати 4 результати..?
Оновлення Koha
Вилучення Koha
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. Екземпляри АБІС Koha вилучаються за допомогою команди
koha-remove ukr_unimarc
Перегляд переліку наявних екземплярів
koha-list
Остаточне вилучення пакунків Koha
apt-get purge koha koha-common
Налаштування
Щодо додаткових налаштувань та адаптацій див. тут: Налаштування Koha, встановленої з джерела.