Відмінності між версіями «Встановлення Koha з репозитарію на ОС Debian»
Dubyk (обговорення • внесок) м (→Кроки веб-встановлювача) |
Dubyk (обговорення • внесок) м (→Кроки веб-встановлювача) |
||
Рядок 241: | Рядок 241: | ||
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin). | На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin). | ||
+ | |||
+ | Встановлення завершено!. | ||
= Оновлення Koha = | = Оновлення Koha = |
Версія за 12:39, 9 квітня 2012
Розглядається встановлення АБІС Koha серії 3.6 з репозитарію 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
Встановлення ОС 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
Також читаємо стандартну інструкцію про подальше налаштування
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.1
2) Для підтримки 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
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
Створюємо файл
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
sort-string-utf.chr
Створюємо файл /etc/koha/zebradb/lang_defs/uk/sort-string-utf.chr наступного змісту
# Generic character map. # encoding utf-8 # Define the basic value-set. *Beware* of changing this without re-indexing # your databases. lowercase {0-9}{a-z}абвгґдеэєжзіїийклмнопрстуфхцчшщьыъюяёў uppercase {0-9}{A-Z}АБВГҐДЕЭЄЖЗІЇИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЮЯЁЎ # 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] [--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
Вивід:
cat: /etc/koha/passwd: No such file or directory Koha instance is empty, no staff user created. Enabling site ukr_unimarc. To activate the new configuration, you need to run: service apache2 reload Restarting web server: apache2 ... waiting . Starting Zebra server for ukr_unimarc
Веб-встановлювач
У файлі /etc/koha/sites/ukr_unimarc/koha-conf.xml у розділі config знаходимо користувача (user) та пароль (pass).
Актуальні українські 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)
Кроки веб-встановлювача
Крок 1: мова uk-UA, перевірка залежностей
Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв
Крок 3: створення таблиць, вибір МАРК-стандарту (Unimarc), вибір типових даних (вибираємо усе, окрім unimarc_bibliographic_DEFAULT_local_952_obsolete)
На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin).
Встановлення завершено!.
Оновлення Koha
Вилучення Koha
Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення экземплярів АБІС Koha. Экземпляри АБІС Koha вилучаються за допомогою команди
koha-remove ukr_unimarc