Коротка інструкція для адміністратора АБІС Koha

Матеріал з Koha Ukraine Wiki
Перейти до навігації Перейти до пошуку

Встановлення та адміністрування ОС Debian GNU/Linux

Вибір ОС Debian GNU/Linux

Для АБІС Koha найбільш придатною на даний момент є операційна система Debian GNU / Linux. Тут і перевірена часом стабільність і той факт, що більшість розробників працює з нею. Поки тільки для цієї системи є всі необхідні perl-модулі в офіційному репозитарії. Також розробники Koha вже досить давно готують пакет з АБИС Koha для репозитория Debian, що дозволить встановлювати систему з „одного кліку“.

IMAGE

Налаштування Debian для АБІС Koha

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

Локаль з UTF-8

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

sudo locale

в результаті повинно фігурувати „UTF-8“ (en.UTF-8, uk_UA.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“ відкриваємо для редагування файл привілеїв адміністратора (/etc/sudoers) і даємо їх користувачеві АдміністраторСистемиKoha, додавши в кінці файлу рядок

АдміністраторСистемиKoha ALL = (ALL) ALL

Після додавання клавіатурній командою Ctrl-O зберігаємо файл (/etc/sudoers) і через Ctrl-X виходимо.

Встановлення та налаштування додаткових пакунків

Встановленні безпосередньо ПЗ Koha передує встановлення усіх необхідних пакунків й модулів, від яких залежить Koha.

Встановлення пакунків з репозитаріїв

Веб-сервер, БД MySQL і додаткові пакунки

Однією командою

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

Однією командою

sudo apt-get install \
libcgi-session-perl \
libclass-factory-util-perl \
libdata-ical-perl \
libdate-calc-perl \
libdate-ical-perl \
libdate-manip-perl \
libdatetime-format-mail-perl \
libdatetime-format-strptime-perl \
libdatetime-format-w3cdtf-perl \
libdatetime-locale-perl \
libdatetime-perl \
libdatetime-timezone-perl \
libdbd-mysql-perl \
libdbi-perl \
libemail-date-perl \
libgd-barcode-perl \
libhtml-scrubber-perl \
libimage-magick-perl \
libjson-perl \
liblingua-ispell-perl \
liblingua-stem-perl \
liblist-moreutils-perl \
liblist-moreutils-perl \
liblocale-gettext-perl \
liblocale-po-perl \
libmail-sendmail-perl \
libmime-lite-perl \
libnet-ldap-perl \
libpdf-api2-perl \
libpoe-perl \
libtext-charwidth-perl \
libtext-csv-perl \
libtext-iconv-perl \
libtext-wrapi18n-perl \
libtimedate-perl \
libtime-duration-perl \
libtime-format-perl \
libunix-syslog-perl \
libxml-dom-perl \
libxml-dumper-perl \
libxml-libxml-perl \
libxml-libxslt-perl \
libxml-namespacesupport-perl \
libxml-parser-perl \
libxml-perl \
libxml-regexp-perl \
libxml-sax-writer-perl \
libxml-simple-perl \
libxml-xslt-perl \
libyaml-syck-perl \
libbiblio-endnotestyle-perl \
libcgi-session-serialize-yaml-perl \
libhtml-template-pro-perl \
libmarc-charset-perl \
libmarc-crosswalk-dublincore-perl \
libmarc-xml-perl \
libmarc-record-perl \
libnet-z3950-zoom-perl \
libpdf-reuse-perl \
libpdf-reuse-barcode-perl \
libschedule-at-perl \
libxml-rss-perl \
libyaml-perl \
libalgorithm-checkdigits-perl \
libhttp-oai-perl \
libsms-send-perl \
libtemplate-perl \
libmemoize-memcached-perl \
libbusiness-isbn-perl \
libdbd-sqlite2-perl \
libuniversal-require-perl \
libtext-csv-encoded-perl \
libpdf-api2-simple-perl \
libpdf-table-perl \
libnet-server-perl \
libnumber-format-perl \
liblocale-currency-format-perl \
liblingua-stem-snowball-perl \
libgraphics-magick-perl \
libauthen-cas-client-perl
Zebra та Yaz

Однією командою

sudo apt-get install \
idzebra-2.0-common \
idzebra-2.0-doc \
idzebra-2.0 \
idzebra-2.0-utils \
libidzebra-2.0-dev \
libidzebra-2.0-0 \
libidzebra-2.0-mod-alvis \
libidzebra-2.0-mod-grs-marc \
libidzebra-2.0-mod-grs-regx \
libidzebra-2.0-mod-grs-xml \
libidzebra-2.0-mod-text \
libidzebra-2.0-modules \
yaz \
yaz-doc \
libyaz4 \
libyaz4-dev
Інші пакунки

Однією командою

sudo apt-get install \
gettext \
libgcrypt11-dev \
libgcrypt11 \
libgd2-noxpm-dev \
libmysqlclient-dev \
libxml2-dev \
libxml2 \
libxml2-utils \
libxslt1.1 \
libxslt1-dev \
memcached \
libapache2-mod-perl2
Пакунки з гілок Дебіен „unstable“ або „testing“

1) Створюємо файл /etc/apt/apt.conf і додаємо наступне

# Зробити „squeeze“ дистрибутивом за умовчанням
APT::Default-Release "squeeze";

2) Створюємо файл /etc/apt/preferences і додаємо наступне (щоб у стабільній гілці „squeeze“ був вищий пріоритет)

Package: *
Pin: release a=squeeze
Pin-Priority: 900

Package: *
Pin: release a=unstable
Pin-Priority: 90

3) У файл /etc/apt/sources.list додаємо наступне джерело

# Джерело пакунків з гілки Дебіен „unstable“
deb http://http.us.debian.org/debian unstable main contrib non-free

4) Встановлення пакунків з гілки «unstable“

sudo apt-get update
sudo apt-cache policy libcgi-session-driver-memcached-perl
sudo apt-get -t unstable install libcgi-session-driver-memcached-perl

Налаштування пакунків

Apache

1) Модулі

Включаємо модуль Rewrite

sudo a2enmod rewrite

а також модулі Expires та Deflate

sudo a2enmod expires
sudo a2enmod deflate

2) Правимо /etc/apache2/conf.d/charset

AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

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

sudo /etc/init.d/apache2 restart
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

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

Отримання Koha

Створення БД для Koha у MySQL

Перевірка аналізатора SAX Parser

Перевірка чи встановлені усі необхідні пакунки

Запуск інсталятора

Відповіді на питання

Компіляція та встановлення Koha

Змінні оточення і доналаштування Apache

Віртуальні хости Apache

Сервер Zebra

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

Налаштування переіндексації за розкладом (cron)

Інші періодичні завдання (cron)

Запуск веб-інсталятора

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

Підготовка локалізованих sql-таблиць (в роботі)

Кроки веб-інсталятора

Оновлення безпеки

ОС GNU/Linux Debian

Koha

Консольні інструменти АБІС Koha

Теки та файли АБІС Koha

Періодичні завдання

Консольні утиліти

Оновлення перекладів

Створення архівних копій

Локальні зміни цієї установки АБІС Koha

Латки

Дизайн

Налаштування АБІС Koha у веб-інтерфейсі

Загальні зауваження

Управління

Параметри системи

Параметри групи „Надходження“

Параметри групи „Управління“

Параметри групи „Авторитетні джерела“

Параметри групи „Каталогізація“

Параметри групи „Оборот“

Параметри групи „Творці“

Параметри групи „Розширений вміст“

Параметри групи „Інтернаціоналізація/локалізація“

Параметри групи „Місцеве використання“

Параметри групи „Протоколи“

Параметри групи „Електронний каталог“

Параметри групи „Відвідувачі“

Параметри групи „Пошуки“

Параметри групи „Серіальні видання“

Параметри групи „Клієнт для бібліотекарів“

Параметри групи „Веб-сервіси“

Інструменти

Див. також