Инструкция
для администратора АБИС Koha
Краткая
инструкция
для администратора АБИС
Koha
Содержание
1. Установка и
администрирование ОС Debian GNU/Linux 2
1.1. Выбор
ОС Debian GNU/Linux 2
1.2. Настройка
Debian для АБИС Koha 3
1.2.1.
Предварительные настройки 3
1.2.1.1. Локаль
з UTF-8 3
1.2.1.2.
Пользователь для Koha 3
1.2.2. Установка
и настройка дополнительных пакетов
4
1.2.2.1.
Установка пакетов с репозитариев 4
1.2.2.2.
Настройка пакетов 7
1.3. Установка
Koha 8
1.3.1. Получение
Koha 8
1.3.2. Создание
БД для Koha в MySQL 8
1.3.3. Проверка
анализатора SAX Parser 9
1.3.4. Проверка
установлены ли все необходимые пакеты 9
1.3.5. Запуск
установщика 9
1.3.6. Ответы
на вопросы 10
1.3.7.
Компиляция и установка Koha 12
1.3.8.
Переменные окружения и донастройка
Apache 12
1.3.9.
Виртуальные хосты Apache 13
1.3.10. Сервер
Zebra 13
1.3.11.
Поддержка кириллицы движком поиска
Zebra 13
1.3.12.
Настройка переиндексации по расписанию
(cron) 14
1.3.13. Другие
периодические задания (cron) 14
1.3.14. Запуск
веб-установщика 15
1.3.15. Создание
локализованных шаблонов 15
1.3.16.
Подготовка локализованных sql-таблиц
(в роботе) 15
1.3.17. Шаги
веб-установщика 15
1.4. Обновления
безопасности 16
1.4.1. ОС
GNU/Linux Debian 16
1.4.2. Koha 16
2. Консольные инструменты
АБИС Koha 17
2.1. Папки и
файлы АБИС Koha 17
2.2.
Периодические задания 18
2.3. Консольные
утилиты 20
2.4. Обновление
переводов 23
2.5. Создание
архивных копий 24
2.6. Локальные
изменения этой установки АБИС Koha 24
2.6.1. Патчи 24
2.6.2. Дизайн 25
3. Настройка АБИС Koha в
веб-интерфейсе 26
3.1. Общие
замечания 26
3.2.
Управление 26
3.3. Параметры
системы 30
3.3.1. Параметры
группы «Поступления » 31
3.3.2. Параметры
группы «Управление » 31
3.3.3. Параметры
группы «Авторитетные источники » 32
3.3.4. Параметры
группы «Каталогизация » 33
3.3.5. Параметры
группы «Оборот » 34
3.3.6. Параметры
группы «Создатели » 36
3.3.7. Параметры
группы «Расширенное содержимое » 37
3.3.8. Параметры
группы «Интернационализация/локализация» 39
3.3.9. Параметры
группы «Местное использование » 39
3.3.10.
Параметры группы «Протоколы » 41
3.3.11.
Параметры группы «Электронный каталог
» 42
3.3.12.
Параметры группы «Посетители » 44
3.3.13.
Параметры группы «Поиски » 45
3.3.14.
Параметры группы «Сериальные издания
» 46
3.3.15.
Параметры группы «Клиент для библиотекарей
» 46
3.3.16.
Параметры группы «Веб-сервисы» 47
3.4.
Инструменты 47
Для АБИС Koha наиболее подходящей на данный
момент является операционная система
Debian GNU/Linux. Здесь и проверенная временем
стабильность и тот факт, что большинство
разработчиков работает с ней. Пока
только для этой системы есть все
необходимые perl-модули в официальном
репозитарии. Также разработчики Koha уже
довольно давно готовят пакет з АБИС
Koha для репозитория Debian, что позволит
устанавливать систему с «одного клика».
Проверка
локали:
sudo locale
в результате
должно
фигурировать
«UTF-8»
(en.UTF-8,
ru_RU.UTF-8 и
.т.п.),
например
для России
LANG=ru_RU.UTF-8 LANGUAGE= LC_CTYPE="ru_RU.UTF-8" LC_NUMERIC="ru_RU.UTF-8" LC_TIME="ru_RU.UTF-8" LC_COLLATE="ru_RU.UTF-8" LC_MONETARY="ru_RU.UTF-8" LC_MESSAGES="ru_RU.UTF-8" LC_PAPER="ru_RU.UTF-8" LC_NAME="ru_RU.UTF-8" LC_ADDRESS="ru_RU.UTF-8" LC_TELEPHONE="ru_RU.UTF-8" LC_MEASUREMENT="ru_RU.UTF-8" LC_IDENTIFICATION="ru_RU.UTF-8"
Если UTF-8
не
присутствует,
тогда нужно
установить
локаль
sudo /usr/sbin/update-locale LANG=ru_RU.UTF-8 LANGUAGE="ru_RU:ru"
Добавляем
пользователя
(ниже вместо
«АдминистраторСистеми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.
Одной
командой
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
Одной
командой
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
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
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
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):
su АдминистраторСистемиKoha cd ~/
1)
Для получения
последней
стабильной
Koha —
загружаем
ее с
http://download.koha-community.org
mkdir ~/koha; wget -O ~/koha/koha-latest.tar.gz http://download.koha-community.org/koha-latest.tar.gz
2) Распаковка архива
cd ~/koha; tar -xzf koha-latest.tar.gz
Создаём базу данных Koha3 и привилегии
пользователей для неё:
sudo mysqladmin -uroot -pПарольАдминаMySQL create Koha3 sudo mysql -uroot -pПарольАдминаMySQL
В среде
mysql выполнить
следующие
grant all on Koha3.* to 'ПользовательБДKoha3'@'localhost' identified by 'ПарольПользователяБДKoha3';\ flush privileges; exit
В папке
Koha выполнить
perl ~/koha/koha.local/misc/sax_parser_print.pl
Вы должны увидеть что то такое
XML::LibXML::SAX::Parser=HASH(0x81fe220)
Если же есть PurePerl или Expat, тогда необходимо
править файл /etc/perl/XML/SAX/ParserDetails.ini (запись
про XML::LibXML::SAX::Parser должна быть с самого
низу).
Команда
perl ~/koha/koha.local/koha_perl_deps.pl -c -u -m
выдает список отсутствующих модулей
и модулей, которые необходимо обновить.
Вам необходимо найти и установить эти
модули (вероятно, что список будет
пустым, поскольку все необходимые
пакеты должны упоминаться этом
руководстве выше).
Отсутствующие и модули новых версий
ищите в ветке Debian «unstable» и «testing» или
же в CPAN (Perl-модули з CPAN устанавливаются
командой например «sudo cpan HTTP::OAI»).
Запускаем установщик (в следующей
команде указываем свои данные)
cd ~/koha/koha.local/ INSTALL_BASE=/usr/share/koha3 \ KOHA_USER=АдминистраторСистемиKoha \ KOHA_GROUP=АдминистраторСистемиKoha \ DB_NAME=Koha3 \ DB_USER=ПользовательБДKoha3 \ DB_PASS=ПарольПользователяБДKoha3 \ ZEBRA_MARC_FORMAT=unimarc \ ZEBRA_USER=ПользовательZebra \ ZEBRA_PASS=ПарольПользователяZebra \ INSTALL_PAZPAR2=yes \ USE_MEMCACHED=yes \ perl Makefile.PL
Отвечаем на
вопросы:
By
default, Koha can be installed in one of three ways:
standard:
Install
files
in
conformance
with
the
Filesystem
Hierarchy
Standard
(FHS).
This
is
the
default
mode
and
should
be
used
when
installing
a
production
Koha
system.
On
Unix
systems,
root
access
is
needed
to
complete
a
standard
installation.
single:
Install
files
under
a
single
directory.
This
option
is
useful
for
installing
Koha
without
root
access,
e.g.,
on
a
web
host
that
allows
CGI
scripts
and
MySQL
databases
but
requires
the
user
to
keep
all
files
under
the
user’s
HOME
directory.
dev:
Create
a
set
of
symbolic
links
and
configuration
files
to
allow
Koha
to
run
directly
from
the
source
distribution.
This
mode
is
useful
for
developers
who
want
to
run
Koha
from
a
git
clone.
Installation
mode
(dev,
single,
standard)
[standard]
Please
specify the directory under which most Koha files will be installed.
Note
that if you are planning in installing more than one instance of
Koha, you may want to modify the last component of the directory
path, which will be used as the package name in the FHS layout.
Base
installation
directory
(default
from
environment)
[/usr/share/koha3]
Since
you are using the ‘standard’ install mode, you should run ‘make
install’ as root. However, it is recommended that a non-root user
(on Unix and Linux platforms) have ownership of Koha’s files,
including the Zebra indexes if applicable.
Please
specify a user account. This user account does not need to exist
right now, but it needs to exist before you run ‘make install’.
Please note that for security reasons, this user should not be the
same as the user account Apache runs under.
User
account
(default
from
environment)
[АдминистраторСистемиKoha]
Please
specify the group that should own Koha’s files. As above, this group
need not exist right now, but should be created before you run ‘make
install’.
Group
(default
from
environment)
[АдминистраторСистемиKoha]
Please
specify which database engine you will use to store data in Koha.
The choices are MySQL and PostgreSQL; please note that at the moment
PostgreSQL support is highly experimental.
DBMS
to
use
(Pg,
mysql)
[mysql]
Please
specify the name or address of your database server. Note that the
database does not have to exist at this point, it can be created
after running ‘make install’ and before you try using Koha for the
first time.
Database
server
[localhost]
Please
specify
the
port
used
to
connect
to
the
DMBS
[3306]
Please
specify
the
name
of
the
database
to
be
used
by
Koha
(default
from
environment)
[Koha3]
Please
specify
the
user
that
owns
the
database
to
be
used
by
Koha
(default
from
environment)
[ПользовательБДKoha3]
Please
specify
the
password
of
the
user
that
owns
the
database
to
be
used
by
Koha
(default
from
environment)
[ПарольПользователяБДKoha3]
Koha
can use the Zebra search engine for high-performance searching of
bibliographic and authority records. If you have installed the Zebra
software and would like to use it, please answer ‘yes’ to the
following question. Otherwise, Koha will default to using its
internal search engine.
Please
note that if you choose *NOT* to install Zebra, koha-conf.xml will
still contain some references to Zebra settings. Those references
will be ignored by Koha.
Install
the
Zebra
configuration
files?
(no,
yes)
[yes]
Found
‘zebrasrv’ and ‘zebraidx’ in /usr/bin.
Since
you’ve chosen to use Zebra with Koha, you must specify the primary
MARC format of the records to be indexed by Zebra.
Koha
provides Zebra configuration files for MARC 21 and UNIMARC.
MARC
format
for
Zebra
indexing
(marc21,
normarc,
unimarc)
(default
from
environment)
[unimarc]
Koha
supplies Zebra configuration files tuned for searching either
English (en) or French (fr) MARC records.
Primary
language
for
Zebra
indexing
(en,
fr,
nb)
[en]
Koha
can use one of two different indexing modes for the MARC authorities
records:
grs1
– uses the Zebra GRS-1 filter, available for legacy support dom –
uses the DOM XML filter; offers improved functionality.
Authorities
indexing
mode
(dom,
grs1)
[dom]
Please
specify
Zebra
database
user
(default
from
environment)
[ПользовательZebra]
Please
specify
the
Zebra
database
password
(default
from
environment)
[ПарольПользователяZebra]
Since
you’ve chosen to use Zebra, you can enable the SRU/ Z39.50 Server if
you so choose, but you must specify a few configuration options for
it.
Please
note that if you choose *NOT* to configure SRU, koha-conf.xml will
still contain some references to SRU settings. Those references will
be ignored by Koha.
Install
the
SRU
configuration
files?
(no,
yes)
[yes]
SRU
Database
host?
[localhost]
SRU
port
for
bibliographic
data?
[9998]
SRU
port
for
authority
data?
[9999]
Since
you’ve chosen to use Zebra, you can also choose to install PazPar2,
which is a metasearch tool. With PazPar2, Koha can perform
on-the-fly merging of bibliographic records during searching,
allowing for FRBRization of the results list.
Install
the
PazPar2
configuration
files?
(default
from
environment)
[yes]
Zebra
bibliographic
server
host?
[localhost]
Zebra
bibliographic
port
for
PazPar2
to
use?
[11001]
PazPar2
host?
[localhost]
PazPar2
port?
[11002]
Use
memcached
and
memoize
to
cache
the
results
of
some
function
calls?
This
provides
a
signficant
performance
improvement.
You
will
need
a
Memcached
server
running.
(no,
yes)
[no]
yes
Memcached
server
address?
[127.0.0.1:11211]
Memcached
namespace?
[KOHA]
Would
you
like
to
run
the
database-dependent
test
suite?
(no,
yes)
[no]
К слову, если Вы ошибетесь, или уведите
в конце что ещё не все зависимости
удовлетворены, тогда можете поправить
файл Makefile.PL, внеся в него ответы.
После
завершения опроса Koha выводит список
всех параметров.
make
(здесь не должно быть ошибок или
предостережений)
make test
Здесь появляются
результаты
тестирования
— большинство
должны
проходить
успешно
(ок), в
результате
мы должны
получить
— «Result:
PASS».
И сама
установка:
sudo make install
От установщика была просьба добавить
следующее к переменным окружения,
поэтому добавляем в /etc/environment две
строчки
export KOHA_CONF=/etc/koha3/koha-conf.xml export PERL5LIB=/usr/share/koha3/lib
1) Подключаем в Apache2
конфигурацию для Koha
sudo ln -s /etc/koha3/koha-httpd.conf /etc/apache2/sites-available/Koha3 sudo a2ensite Koha3
2) Добавляем
порты в
/etc/apache2/ports.conf
Listen 80 Listen 8888
Внимание: иногда порт 80 может быть занят
на данном IP/домене — тогда здесь и ниже
временно заменить порт 80 на 8008.
3)
Также
правим
порты в
файле
/etc/koha3/koha-httpd.conf
примерно
так
<VirtualHost *:80> ... ServerName koha:80 ... <VirtualHost *:8888> ... ServerName koha:8888
4) Перезапускаем веб-сервер Apache 2
sudo /etc/init.d/apache2 restart
Для
поддержки автозапуска сервера Zebra
выполняем следующие
sudo ln -s /usr/share/koha3/bin/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon sudo update-rc.d koha-zebra-daemon defaults sudo /usr/share/koha3/bin/koha-zebra-ctl.sh start
Необходимо
добавить кириллические символы в файл
/etc/koha3/zebradb/etc/word-phrase-utf.chr
а конкретнее
— исправить
на следующие:
lowercase {0-9}{a-z}æäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі uppercase {0-9}{A-Z}ÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ
Без этого изменения поиск или не будет
работать или будет давать некорректные
результаты.
Добавляем с помощью команды
sudo crontab -e -u АдминистраторСистемиKoha
следующее задание (корректируем данные
в соответствии ранее указанных в
установщике)
# Задание cron для koha3
1 * * * * env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=usr/share/koha3/lib perl -I /usr/share/koha3/lib /usr/share/koha3/bin/migration_tools/rebuild_zebra.pl -a -b -z 2>&1 > /dev/null
Внимание: также следует проверить
исполнение этого задания и с консоли
для уверенности, что оно будет выполнятся
корректно:
sudo -u АдминистраторСистемиKoha env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=usr/share/koha3/lib perl -I /usr/share/koha3/lib /usr/share/koha3/bin/migration_tools/rebuild_zebra.pl -a -b -z -v
Если будут следующие ошибки:
10:29:41-11/08 zebraidx(29193) [warn] zebra_lock_create fail fname=/var/lock/koha3/zebradb/biblios/norm..LCK [No such file or directory] 10:29:41-11/08 zebraidx(29193) [warn] zebra_lock_create fail fname=/var/lock/koha3/zebradb/biblios/shadow..LCK [No such file or directory]
тогда
cd /var/lock/koha3/ mkdir zebradb chmod ugoa+r+w+x zebradb cd zebradb/ mkdir biblios chmod ugoa+r+w+x biblios
1)
«Облака»
меток и
классификации
(для
классификаций
необходимо
править
build_browser_and_cloud.pl
и
opac-browser.tmpl)
# Задание cron для koha3 (пример для УДК (3 деления) и Unimarc)
0 0 * * * env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=usr/share/koha3/lib perl -I /usr/share/koha3/lib /usr/share/koha3/bin/cronjobs/build_browser_and_cloud.pl -b -f 675a -t 606 -c -m 3
В
веб-браузере
вводим
адрес
нашего
сервера
http://localhost:8888?language=ru-RU
(должен появится запрос на вход в систему
и подальшей установки)
Пока не продолжаем, поскольку в исходных
кодах не доступны локализированные
шаблоны для других языков кроме
английского. Шаблоны для русского,
украинского и т.д. необходимо сгенерировать.
Переходим
в папку скриптов локализации Коха
cd /usr/share/koha3/misc/translator
и запускаем создание локализованных
шаблонов для каждого языка
sudo env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=usr/share/koha3/lib perl -I /usr/share/koha3/lib "./translate" install ru-RU sudo env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=usr/share/koha3/lib perl -I /usr/share/koha3/lib "./translate" install uk-UA ... и для других нужных языков (кроме «en»)
Рабочие
файлы з
таблицами
(в DrobBox
Сергея
Дубика)
для русской
и
украинской
sql-локализации
находятся
по адресу:
Папки
ru-RU/ и
uk-UA/
необходимо
разместить
(заменить
существующие)
в рабочем
каталоге
Коха
/usr/share/koha3/intranet/cgi-bin/installer/data/mysql
После этого необходимо перезагрузить
сервер (веб-установщик почему-то иначе
не видит другие языки кроме английского).
Далее
продолжаем в веб-баузере
http://localhost:8888?language=ru-RU
Регистрируемся (вспоминаем логин
АдминистраторСистемиKoha и пароль
ПарольАдминистратораСистемиKoha)
Шаг 1.
Выбор
языка: ru-RU
Проверка
установленных зависимостей (пакеты)
Шаг 2.
Вывод
настроек БД
Проверка
существования
БД Koha3
и привилегий
доступа
пользователя
АдминистраторСистемиKoha
Шаг 3.
Подготовка
таблиц
Создание
таблиц
Подготовка
базовой настройки
Выбор
стандарта МАРК-записей: Unimarc
Выбор sql-таблиц
для импорта — выбрать все
Продолжаем…
Импорт sql-таблиц
Смотрим
нет ли ошибок импорта sql-таблиц.
Для возможности
установки обновлений безопасности в
/etc/apt/sources.list должна быть строка
deb http://security.debian.org/ squeeze/updates main contrib non-free
Установка обновлений
производится командами
sudo
apt-get
update
sudo
apt-get
upgrade
Системному
администратору желательно подписаться
на список рассылки «Debian Security Announce»:
http://lists.debian.org/debian-security-announce/
и проводить
обновления если в рассылке упоминаются
установленные в системе пакеты.
В последние время
команда разработчиков Koha выпускают
новую «минорную» (третья цифра) версию
раз в месяц и примерно раз в полгода
/год «мажорную» (вторая цифра). В минорных
версиях как правило значительных
нововведений нет но часто устраняются
какие-то недочёты или проблемы с
безопасностью.
За новостями о
Koha легко следить через сервис Nabble:
http://koha.1045719.n5.nabble.com/Koha-f3047917.subapps.html
(здесь собрано
большинство списков рассылок о Koha).
Перед обновлением
обязательно нужно сделать резервные
копии БД и каталогов с настройками,
perl-скриптами и веб-шаблонами Koha.
Также желательно
настроить периодическое полное или
частичное резервирование сервера с
АБИС Koha на другой сервер или сетевое
хранилище.
Детальные инструкции
по обновлению можно найти или по адресу
http://wikitntu.org.ua/{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}9E{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}BD{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}BE{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}B2{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}BB{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}B5{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}BD{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}BD{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D1{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}8F_Koha,_{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}B2{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D1{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}81{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D1{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}82{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}B0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}BD{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}BE{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}B2{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}BB{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}B5{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}BD{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}BE{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D1{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}97_{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}B7_{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}B4{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}B6{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}B5{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D1{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}80{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}B5{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}BB{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}D0{cf4bc7f02e65cc3906f5f4d514caf48a67ea687009adb2b5cd2c9c5ee918c4ba}B0
или на сайте АБИС
Koha (http://koha-community.org).
Предостережение:
обновление
Koha
рассчитано
на
«чистую»
некастомизированную
(относительно
скриптов,
шаблонов,
типовой
структуры
БД)
установку
Koha.
Как
правило,
все
локальные
изменения
в
БД,
perl-скриптах
и
веб-шаблонах
после
обновления
пропадают.
Поэтому
после
обновления
нужно
возобновить
(и
адаптировать
к
новой
версии)
все
локальные
изменения
а
также
детально
проверить
затрагиваемую
ими
функциональность.
Здесь приведены папки для одной
конкретной установке Koha (В других
установках папки будут немного
отличаться).
/etc/koha3210/
—
файлы настройки
Koha,
виртуальные
хосты для
Apache, файлы
настройки
движка
Zebra
/usr/share/koha3210/
—
основной
каталог
АБИС Koha,
содержит
/usr/share/koha3210/
bin/
—
консольные
утилиты
(для
поисковой
индексации,
миграции,
проверок
и
т.
п.),
как
правило,
для
времязатратных
операций
/usr/share/koha3210/
doc/release_notes/
—
собрание
примечаний
о
всех
версиях
Koha
/usr/share/koha3210/
intranet/cgi-bin/
—
perl-скрипты
всех
модулей
библиотечного
интерфейса
(БИ)
/usr/share/koha3210/intranet/htdocs/intranet-tmpl/prog/
—
локализированные
веб-шаблоны
модулей
библиотечного
интерфейса
/usr/share/koha3210/
opac/cgi-bin/
—
perl-скрипты
электронного
каталога
(ЭК)
/usr/share/koha3210/opac/htdocs/intranet-tmpl/prog/
—
локализированные
веб-шаблоны
электронного
каталога
/usr/share/koha3210/
lib/C4/
—
общие
perl-модули
/usr/share/koha3210/
man/man3/
—
документация
в
man-формате
для
perl-модулей,
модулей
БИ/ЭК
/usr/share/koha3210/misc/translator/
—
инструменты
локализации
а
также
файлы
переводов
(с
http://translate.koha-community.org/)
/usr/share/koha3210/
misc/koha-install-log
—
файл
журнала
установки
(используется
при
обновлении)
/var/log/koha3210/
—
системные
журналы
Koha
/var/lib/mysql/Koha3210
—
файлы
БД
MySQL
«Koha3210»
с
данными
(не
для
бэкапов)
/var/lib/koha3210/zebradb/
/var/lock/koha3210/zebradb/
—
файлы
БД
Zebra
Разнообразные
периодические
задания в
виде
perl-скриптов
собраны в
папке
/usr/share/koha3210/bin/cronjobs:
crontab.example
—
пример
перечня
периодических
заданий;
holds/build_holds_queue.pl,
holds/cancel_expired_holds.pl
—
работа
с
очередью
резервирований
и
устаревшими
резервированиями;
rss/rss.pl
и
дополнительные
файлы
—
периодическая
подготовка
RSS-каналов
согласно
шаблонам;
stats/monthly_circulation_statistics.pl,
stats/monthly_new_items_statistics.pl,
stats/monthly_new_patron_statistics.pl
—
подготовка
месячной
статистики
в
CSV-формате
по
обороту,
новым
поступлениям
и
посетителям;
MARC21_parse_test.pl
—
периодический
анализ
и
возможное
исправление
xml-полей
biblioitems.marcxml;
advance_notices.pl
—
подготовка
оповещений
о
возвращении
и
помещение
их
в
очередь;
backup.sh
—
пример
сценария
архивирования
БД;
build_browser_and_cloud.pl
—
сценарий
для
создания
облака
пользовательских
меток
и
классификационного
дерева;
cart_to_shelf.pl
—
сценарий
для
автоматической
смены
расположения
«CART»
на
обыкновенное
(для
данного
экземпляра)
полочное
расположение;
check-url.pl
—
проверка
URL-ссылок
в
библиографических
записях;
cleanup_database.pl
—
очистка
таблиц
sessions
и
zebraqueue
(полностью
или
только
старые
записи);
cloud-kw.pl,
cloud-sample.conf
—
создание
облака
ключевых
слов
на
основании
указателя
Zebra
(настройка
в
файлах
*.conf);
create_koc_db.pl
—
создание
файла
БД
для
инструмента
офлайновой
книговыдачи;
fines.pl
—
сценарий
начислений
пени;
gather_print_notices.pl
—
вывод
всех
ожидающих
уведомлений
в
файл;
j2a.pl
—
изменяет
тип
пользователя
с
«J»
на
«A»
при
достижении
18-летия;
longoverdue.pl
—
сценарий
установки
статусов
утраты
для
давно
простроченных
книг
и
начисления
штрафов;
notifyMailsOp.pl
—
уведомления
электронной
почтой;
overdue_notices.pl
—
подготовка
сообщений
о
простроченных
экземплярах;
printoverdues.sh
—
сценарий
преобразования
html>pdf
файлов
и
распечатки
их;
process_message_queue.pl
—
сценарий
обработки
очереди
сообщений;
runreport.pl
—
сценарий
выполнения
подготовленных
отчётов;
serialsUpdate.pl
—
сценарий
обновления
подписки
на
сериальные
издания;
services_throttle.pl
—
нужно
для
сбрасывания
дросселя
услуг
xisbn;
smsoverdues.pl
—
сценарий
передачи
посетителям
SMS-сообщений
о
пени
или
прострочке;
zebraqueue_start.pl
—
сценария
для
запуска
службы
Zebra;
Некоторые
задачи в АБИС Koha выполняются консольными
утилитами. Их можно найти с следующих
папках:
/usr/share/koha3210/bin
/usr/share/koha3210/misc/translator
Нище
перечислены существующие утилиты:
(папка
/usr/share/koha3210/bin)
admin/koha-preferences
— работа
с
системными
переменными
(установка,
изменение,
вывод,
загрузка/выгрузка);
cronjobs/
— периодические
задания
(описано
выше);
interface_customization/
— исходные
файлы
koha3-staff-client-logo.*
и
koha3-opac-button-background.*;
load_testing/
— тесты
на
быстродействие,
регресии
и
т.п.
для
оборота
и
веб-служб
(сценарии
benchmark_circulation.pl
и
benchmark_webservices.pl);
maintenance/
—
MARC21_utf8_flag_fix.pl
— исправление
значения
позиции
9
маркера
для
MARC21
–
UTF8,
UNIMARC_fix_collectiontitle.pl
— проверка
biblioitems.collectiontitle,
UNIMARC_sync_date_created_with_marc_biblio.pl
— datecreated->099c
и
timestamp->099d,
fix_accountlines_date.pl
— исправления
даты
для
пени,
sync_items_in_marc_bib.pl
— замена
экземплярных
данных
в
МАРК-полях
на
данные
с
таблицы
items;
migration_tools/
— скрипты
используемые
при
миграции
данных,
для
создания/обновления
поискового
указателя
и
т.п.,
22_to_30/
— набор
скриптов
для
обновления
Коха
серии
2.2.х
к
3.0,
build6xx.pl
— пересоздание
заданного
тезауруса
(авторитетного
файла)
на
основании
данных
биб-записи,
buildCOUNTRY.pl
— скрипт
пересоздания
списка
стран
(COUNTRY)
из
существующих
стран
в
биб-записях,
buildEDITORS.pl
— скрипт
пересоздания
списка
EDITORS
(для
плагинов
210c
и
225a),
buildLANG.pl
— скрипт
пересоздания
списка
языков
(LANG)
из
существующих
языков
в
биб-записях,
bulkauthimport.pl
— скрипт
импорта
файлов
авторитетных
записей
формата
MARCXML
или
ISO2709,
bulkmarcimport.pl
— скрипт
импорта
файлов
библиографических
записей
формата
MARCXML
или
ISO2709,
fix_onloan.pl
— обновление
статуса
„на
выдаче“
для
экземпляров,
merge_authority.pl
— утилита
для
объединения
двух
авторитетных
записей,
rebuild_nozebra.pl
— основной
сценарий
создания
поисковых
указателей
для
режима
NoZebra,
rebuild_zebra.pl
— основной
сценарий
создания
поисковых
указателей
для
режима
Zebra,
remove_unused_authorities.pl
— удаление
авторитетных
записей,
не
привязанных
к
биб-записям,
upgradeitems.pl
— обновление
экземплярных
записей
в
биб-записи
(для
поля
995,
Unimarc);
spellcheck_suggest/make_spellcheck_suggest.pl
— начальная
реализация
проверки
правописания
(Marc21);
batchCompareMARCvsFrameworks.pl
— скрипт
сравнивает
файл
iso2709 и
МАРК-структуру
в Коха
и возвращает
данные
про
используемые/неиспользуемые
подполя;
batchDeleteUnusedSubfields.pl
— удаление
неиспользуемых
МАРК-полей
(не
представленных
в МАРК
структурах);
batchImportMARCWithBiblionumbers.pl
— импорт
ISO2709-файла,
для записей
которого
уже
существуют
соответствующие
№№ biblio.biblionumber
(MARC21);
batchRebuildBiblioTables.pl
— перестройка
не-MARC БД
с
MARC-значений
(напр., при
изменении
отображения
Koha-MARC);
batchRepairMissingBiblionumbers.pl
— поиск
и исправление
отсутствующих
значений
полей
biblionumber/biblioitemnumber;
batchupdateISBNs.pl
— пакетное
удаление
знака «-»
в значениях
ISBN;
check_sysprefs.pl
— проверка
на
отсутствующие
системные
переменные;
commit_biblios_file.pl
— скрипт
для импорта
заготовленных
ранее
записей
(с помощью
stage_biblios_file.pl
или
инструмента
«Заготовка
МАРК-записей
для
импорта»);
exportauth.pl
— экспорт
авторитетных
файлов в
файл
ISO2709;
koha-pazpar2-ctl.sh
— сценарий
службы
PAZPAR2 для
init.d;
koha-zebra-ctl.sh
— сценарий
службы
ZEBRA для
init.d;
koha-zebraqueue-ctl.sh
— сценарий
службы
ZEBRAQUEUE для
init.d;
kohalib.pl
— сценарий
установки
пути к
модулям
C4;
link_bibs_to_authorities.pl
— сценарий
для
присоединения
к заглавиям
биб-записи
соответствующих
авторитетных
записей;
perlmodule_ls.pl
— вывод
используемых
модулей;
perlmodule_rm.pl
— удаление
perl-модуля;
sax_parser_print.pl
— проверка
текущего
SAX-анализатора
(должен
быть
XML::LibXML::SAX::Parser);
sax_parser_test.pl
— проверка
вывода
XML::SAX;
stage_biblios_file.pl
— загрузка
файла
биб-записей
в хранилище
(для
подальшего
импорта
с помощью
commit_biblios_file.pl
или
инструмента
«Управление
заготовленными
МАРК-записями»);
zebraqueue_daemon.pl
— служба
для слежения
за очередью
Zebra и
обновлении
Zebra если
нужно.
(папка
/usr/share/koha3210/misc/translator)
translate
—
утилита
для
ведения
переводов
в
Koha,
примеры
использования
translate
create
fr-FR
— создание
po-файлов
из
шаблонов
для
языка
fr-FR
,
translate
update
fr-FR
— обновление
существующих
po-файлов
из
папки
шаблонов,
translate
install
fr-FR
— внесение
перевода
из
po-файлов
в
шаблоны
и
описания
системных
параметров
для
языка
fr-FR
,
translate
-p
install
fr-FR
— внесение
перевода
только
для
описаний
системных
параметров,
translate
install
— внесение
переводов
в
шаблоны
для
всех
существующих
языков
(используя
все
po-файлы
в
папке
/usr/share/koha3210/misc/translator/po).
Перевод интерфейса АБИС Koha ведётся на
сайте http://translate.koha-community.org. Например,
для русского языка и для версии 3.2.х
файлы раздел перевода находится здесь:
http://translate.koha-community.org/ru/32/.
О скриптах для перевода уже упоминалось
в разделах «1.3.15. Создание локализованных
шаблонов» и предыдущем.
Для
упрощения
обновления
переводов
Сергеем
Дубиком
написано
несколько
сценариев,
которые
можно найти
в папке
koha_localization_scripts_3.2.X_with_custom:
0_DOWNLOAD_po_from_Koha_32_web.sh
— скачивает
нужные
po-файлы
(для
выбранных
языков и
версии);
1_BACKUP_work_templates.sh
— архивирует
локализированные
папки (для
выбранных
языков);
2_UNION_with_CUSTOM.sh
— объединяет
официальные
po-файлы с
локальными
(в локальных
po-файлах
размещается
локализация
локальной
кастомизации);
3_INSTALL_po_to_work_TEMPLATEs.sh
— копирование
результирующих
po-файлов
в папку
misc/translator/po
и обновление
перевода
папок с
локализированными
шаблонами
интерфейса
(для
выбранных
языков);
all_32.sh
— выполняет
действия
№ 0,2,3 за
раз.
(скрипты выполняются в окружении
пользователя АдминистраторСистемиKoha)
Локальные
po-файлы
имеют
название
подобно
ru-RU-i-opac-t-prog-v-3002000-custom.po.
Архивную
копию БД
желательно
делать
каждый
день и
копировать
на другой
компьютер.
Пример
сценария
бэкапа
упоминался
в периодических
заданиях
(backup.sh).
Также есть
сценарий
архивирования
Сергея
Дубика :
koha_backup_scripts/EXPORT_all_DB_data_and_structure.sh
Данные сценарии нужно доработать под
свои нужды и желательно дополнить
вариантом бэкапа всей системы.
От базовой локальная
установка АБИС Koha может отличаться
настройками
системных переменных;
набором начальных
данных;
структурой БД;
изменениями в
исполняемом коде;
изменениями в
шаблонах пользовательского интерфейса.
Начальные данные и изменённые системные
переменные опустим, поскольку их
перечисление выходит за рамки краткой
инструкции для администратора.
В библиотечном интерфейсе было наложено
2 патча для добавления кириллического
алфавита при поиске посетителя:
intranet/cgi-bin/members/member.pl:
149
my
@letters
=
map
{
{letter
=>
$_}
}
(.
150
‘А’,’Б’,’В’,’Г’,’Д’,’Е’,’Ё’,’Ж’,’З’,’И’,’Й’,’К’,’Л’,’М’,’Н’,’О’,’П’,’Р’,’С’,’Т’,’У’,’Ф’,’Х’,’Ц’,’Ч’,’Ш’,’Щ’,’Ъ’,’Ы’,’Ь’,’Э’,’Ю’,’Я’,
151
‘І’,’Ї’,’Є’,’Ґ’,’Ў’,
152
‘A’
..
‘Z’);
intranet/cgi-bin/members/members-home.pl:
82
my
@letters
=
map
{
{letter
=>
$_}
}
(
83
‘А’,’Б’,’В’,’Г’,’Д’,’Е’,’Ё’,’Ж’,’З’,’И’,’Й’,’К’,’Л’,’М’,’Н’,’О’,’П’,’Р’,’С’,’Т’,’У’,’Ф’,’Х’,’Ц’,’Ч’,’Ш’,’Щ’,’Ъ’,’Ы’,’Ь’,’Э’,’Ю’,’Я’,
84
‘І’,’Ї’,’Є’,’Ґ’,’Ў’,
85
‘A’
..
‘Z’);
Также
частично изменялся файл периодической
подготовки облака меток и иерархии по
классификации:
bin/cronjobs/build_browser_and_cloud.pl
Здесь будут указаны только файлы,
которых коснулись изменения. Изменялся
дизайн электронного каталога для
реализации различимого интерфейса для
двух подразделений. Изменения вносились
в каталог opac/htdocs/opac-tmpl/prog/en/и затем
размножались на другие локализорованные
каталоги путём обновления переводов
(упоминалось выше).
Итак, были изменены следующие файлы:
css/opac.css
добавлен
css/opac_fschool.css
добавлен
css/opac_university.css
includes/doc-head-close.inc
includes/masthead.inc
includes/opac-bottom.inc
modules/opac-account.tmpl
modules/opac-auth.tmpl
modules/opac-browser.tmpl
modules/opac-main.tmpl
modules/opac-passwd.tmpl
modules/opac-readingrecord.tmpl
modules/opac-search-history.tmpl
modules/opac-shelves.tmpl
modules/opac-suggestions.tmpl
modules/opac-tags.tmpl
modules/opac-user.tmpl
modules/opac-userupdate.tmpl
В этом модуле производятся основные
настройки АБИС Koha для конкретной
библиотеки.
Желательно первоначальное настраивание
производить в таком порядке в каком
приводится описание этапов настройки.
Внесение изменений в этом модуле нужно
производить с большой осторожностью,
особенно после внесения данных.
Посетители, находящиеся дома,
Посетитель,
Студент,
Несовершеннолетний,
Ребёнок,
Юноша,
Библиотека,
Межбиблиотечный обмен,
Школа,
Преподаватель,
Совет,
Персонал
библиотеки.
Класс, группа,
Научная степень,
Образовательно-квалификационный
уровень,
Подразделение, отделение,
Образование,
Учебное заведение,
Этническая принадлежность,
Замечания по этнической принадлежности,
Факультет,
Отец, ФИО,
Отец, электронная почта,
Отец, телефон,
Идентификатор LDAP,
Мать, ФИО,
Мать, электронная почта,
Мать, телефон,
Национальность,
Когда выдан паспорт,
Серия и номер паспорта
Где выдан паспорт,
Отчество,
Профессия,
Показывать штрих-код на сводном
экране списков экземпляров,
Научное звание,
Должность.
Структура по умолчанию,
Аудиоматериаллы на кассетах, CD,
Видеоматериаллы (DVD, VHS),
Книги (монографические издания),
Книги Филипповской школы,
Комплекты, наборы смешанных материалов,
Модели,
Переплёт (издательский,
распространительский, владельческий
конволют),
Продолжающиеся (сериальные) издания,
Структура быстрого добавления,
Электронные ресурсы
(диски, веб, файлы,
…)
По умолчанию,
Хронологическое понятие,
Наименование коллектива или юрисдикции,
Термин жанра/формы,
Географическое название,
Наименование мероприятия,
Имя лица,
Тематический термин,
Унифицированное заглавие
Параметры системы используются
для детальной настройки всех модулей
АБИС Koha. Некоторые параметры (напр.
marcflavour
)
не должны
изменятся после первоначальной
настройки, большинство других можно.
Многие параметры включают/выключают
дополнительные возможности, вид
интерфейса, поведение и многое другое
АБИС Koha. Параметры для удобства разбиты
на следующие группы:
Поступления
Управление
Авторитетные
источники
Каталогизация
Оборот
Создатели
Расширенное
содержимое
Интернационализация/локализация
Местное
использование
Протоколы
Электронный
каталог
Посетители
Поиски
Сериальные
издания
Клиент для
библиотекарей
Веб-сервисы
Рассмотрим детальнее (описания приведены
частично, из перечисления подано только
значение по умолчанию (выделено
курсивом)).
Печать
OrderPdfFormat
Правила
AcqCreateItem
CurrencyFormat
— показывать денежные значения в
следующем формате: 360
000, 00
gist
— налоговая ставка по умолчанию равна:
0.20
.
Аутентификация
через CAS
casAuthentication
casLogout
casServerUrl
Параметры
входа
AutoLocation
—
не
требовать
чтобы персонал библиотеки входил в
систему с компьютера, IP-адрес которого
принадлежит диапазона IP-адресов его
библиотеки (если указано).
IndependantBranches
— не
препятствовать
персоналу библиотеки (кроме
супербиблиотекарей) изменять объекты
(резервирование, экземпляры, посетители
и т.д.), принадлежащие другим библиотекам.
insecure
SessionStorage
timeout
—
автоматический выход пользователей
после 12000000
миллисекунд бездействия.
Параметры
интерфейса
DebugLevel
delimiter
— отделять столбцы в экспортированном
отчете через точки
с запятой ;
по умолчанию.
KohaAdminEmailAddress
— использовать root@localhost
в качестве адреса электронной почты
администратора АБИС Коха. (Это типичный
адрес для отправителя электронной
почты, хотя у каждого отдельного
подразделения есть и своя электронная
почта, — этот используется, когда
случается внутренняя ошибка.)
noItemTypeImages
virtualshelves
— разрешить
работникам библиотеки и посетителям
создавать и просматривать сохраненные
списки книг.
BiblioAddsAuthorities
— при редактировании записей запретить
также автоматически создавать, при
необходимости, новые авторитетные
записи, вместо того, чтобы ссылаться
на уже существующие авторитетные
источники.
dontmerge
— не
выполнять
автоматическое обновление связанных
библиотечных записей при изменении
авторитетной записи. Если эта опция
выключена, пожалуйста, попросите
администратора задействовать
периодическое задание «merge_authorities.pl»
в «cronjob».
Интерфейс
advancedMARCeditor
— показывать
описания полей и подполей в МАРК-редакторе.
DefaultClassificationSource
—
использовать УДК
в качестве источника классификации
по умолчанию.
Наклейки на
корешке
SpineLabelAutoPrint
SpineLabelFormat
SpineLabelShowPrintOnBibDetails
Отображение
authoritysep
— отделять несколько авторов, серий
или тематик с помощью «--»
.
hide_marc
—
IntranetBiblioDefaultView
о
— п
умолчанию, отображать библиографическую
запись в обычной форме.
ISBD
— шаблон карточки ISBD (набор строк типа
«#686|<br/>
ББК |{686a }|»).
LabelMARCView
OpacSuppression
URLLinkText
Структура
записи
autoBarcode
— штрих-коды формируются
последовательно (1,2,3)
item-level_itypes
itemcallnumber
— Отображать MARC-подполе 942hv
в шифр хранения экземпляра. (Информация
может включать несколько подполей,
которые могут использоваться: например,
при 680ab будут просматриваться подполя
«a» и «b» с 680). Примеры:
Дьюи:
676a(Unimarc) / (082ab или 092ab)(Marc21);
УДК:
675a(Unimarc);
КБК: 680ab(Unimarc) / (050ab или
090ab)(Marc21);
ББК и др.: 686abс(Unimarc);
с
экземплярной записи: 852gkl(Unimarc) /
852hi(Marc21)
marcflavour
— толковать и хранить MARC-записи в
UNIMARC
-формате.
MARCOrgCode
— введите <a
href="http://www.loc.gov/marc/organizations/orgshome.html">MARC-код
организации</a> ____, который будет
использоваться по умолчанию в новых
MARC-записях (оставьте пустым если код
неизвестен).
NewItemsDefaultLocation
— когда создаются экземпляры,
предоставлять им временное расположение
_____ (должно быть кодом расположения,
или пустым если не используется).
z3950NormalizeAuthor
z3950AuthorAuthFields
Интерфейс
AllowAllMessageDeletion
CircAutocompl
DisplayClearScreenButton
FilterBeforeOverdueReport
itemBarcodeInputFilter
numReturnedItemsToShow
— показывать 20
последних возвращенных экземпляров
на экране возвратов.
previousIssuesDefaultSortOrder
soundon
— разрешить
оборотные звуки при выдаче и возвращении
в интерфейсе библиотекарей. Поддерживается
пока не всеми веб-браузерами.
SpecifyDueDate
— разрешить
библиотечному персоналу указывать
дату возвращения (ожидания) при
оформлении выдачи.
todaysIssuesDefaultSortOrder
UseTablesortForCirc
Правила выдачи
AllowNotForLoanOverride
AllowRenewalLimitOverride
AutomaticItemReturn
— осуществлять автоматическое
перемещение экземпляров к их исходному
подразделению при их возвращении.
ceilingDueDate
CircControl
globalDueDate
HomeOrHoldingBranch
HomeOrHoldingBranchReturn
InProcessingToShelvingCart
IssuingInProcess
maxoutstanding
noissuescharge
OverdueNoticeBcc
OverduesBlockCirc
— не
блокировать
выдачу посетителю, который имеет
просроченные неуплаты
PrintNoticesMaxLines
RenewalPeriodBase
ReturnBeforeExpiry
ReturnToShelvingCart
TransfersMaxDaysWarning
UseBranchTransferLimits,
BranchTransferLimitsType
— не
соблюдать
ограничений на перемещение между
подразделениями, основанных на шифре
собрания
useDaysMode
—
рассчитывать дату возвращения (ожидания)
используя календарь,
чтобы пропустить все дни, когда
библиотека закрыта.
Правила
резервирования
AllowHoldDateInFuture
AllowHoldPolicyOverride
AllowHoldsOnDamagedItems
AllowOnShelfHolds
canreservefromotherbranches
— разрешить
пользователям из одной библиотеки
размещать резервирование на экземпляры
из другой библиотеки
DisplayMultiPlaceHold
emailLibrarianWhenHoldIsPlaced
maxreserves
— посетители могут иметь лишь 50
резервирований за один раз.
OPACAllowHoldDateInFuture
ReservesControlBranch
ReservesMaxPickUpDelay
ReservesNeedReturns
StaticHoldsQueueWeight,
RandomizeHoldsQueueWeight
— выполнять резервирование из библиотек
______ (коды подразделений, через запятую,
если пусто, то используются все
библиотеки) в данном порядке.
Правила
штрафов
finesCalendar
— расчет штрафов основывается на
количестве просроченных дней исключая
дни когда библиотека закрыта.
finesMode
— подсчитывать
(но только для высылки администратору)
штрафы (для случая когда выполняется
периодическое задание misc/cronjobs/fines.pl
).
Самообслуживание
AutoSelfCheckAllowed
AutoSelfCheckID
AutoSelfCheckPass
ShowPatronImageInWebBasedSelfCheck
WebBasedSelfCheck
— не
задействовать
веб-ориентированную систему
самообслуживания (доступна по адресу:
/cgi-bin/koha/sco/sco-main.pl).
Карточки
посетителей
ImageLimit
— ограничить количество изображений
создателя (карточек клиентов), что
храниться в базе данных до 5
изображений.
Все
FRBRizeEditions
OPACFRBRizeEditions
— не
показывать
другие издания единицы в электронном
каталоге.
Amazon.com
AmazonAssocTag
AmazonCoverImages
AmazonEnabled
AmazonLocale
AmazonReviews
AmazonSimilarItems
AWSAccessKeyID
— доступ к содержимому Amazon, используя
ключ доступа ________ (бесплатно, ссылка:
http://aws.amazon.com).
AWSPrivateKey
— доступ к содержимому Amazon (кроме
обложек книг) с использованием частного
ключа ________ (бесплатно, ссылка:
http://aws.amazon.com).
OPACAmazonCoverImages
OPACAmazonEnabled
OPACAmazonReviews
OPACAmazonSimilarItems
Babeltheque.com
Babeltheque
— не
включать
информацию (вроде отзывов и цитат) с
Babelthèque.com на странице подробностей о
записи в электронном каталоге.
Baker &
Taylor (btol.com)
BakerTaylorBookstoreURL
BakerTaylorEnabled
BakerTaylorUsername
,
BakerTaylorPassword
— иметь доступ к «Бейкер & Тейлор»,
используя имя пользователя ___ и пароль
____.
Google.com
GoogleJackets
— не
добавлять
обложки с «Google Книги» в результаты
поиска и на странице подробностей
записи в электронном каталоге.
LibraryThing.com
LibraryThingForLibrariesEnabled
LibraryThingForLibrariesID
— иметь доступ к «Library Thing для библиотек»,
используя идентификатор клиента _____
.
LibraryThingForLibrariesTabbedView
ThingISBN
OCLC.org
OCLCAffiliateID
— использовать «идентификатор партнера
Онлайнового компьютерного библиотечного
центра (OCLC)» ________ для доступа к сервису
xISBN. Обратите внимание, что, если Вы
подписались на данный «OCLC affiliate ID», Вы
ограничены до 1000 запросов в день.
XISBN
XISBNDailyLimit
Syndetics.com
SyndeticsAuthorNotes
SyndeticsAwards
SyndeticsClientCode
— использовать код клиента ___ для
доступа к Syndetics.
SyndeticsCoverImages
SyndeticsCoverImageSize
SyndeticsEditions
SyndeticsEnabled
SyndeticsExcerpt
SyndeticsReviews
SyndeticsSeries
SyndeticsSummary
SyndeticsTOC
Пользовательские
метки
TagsEnabled
— разрешить
посетителям и работникам библиотеки
ставить метки на биб-записи.
TagsExternalDictionary
TagsInputOnDetail
TagsInputOnList
TagsModeration
TagsShowOnDetail
TagsShowOnList
dateformat
— формат даты согласно шаблону
дд/мм/гггг.
language
English(en)
— задействовать следующие языки в
библиотечном интерфейсе:
Українська(uk-UA) Русский(ru-RU)
opaclanguages
English(en)
— задействовать следующие языки для
ЭК:
Українська(uk-UA) Русский(ru-RU)
opaclanguagesdisplay
— разрешить
посетителям менять язык, на каком они
видят интерфейс ЭК.
AllFinesNeedOverride
AllowFineOverride
AllowPurchaseSuggestionBranchChoice
AllowSelfCheckReturns
AlternateHoldingsField
AlternateHoldingsSeparator
AnonymousPatron
— использовать системный номер
пользователя ____ для анонимного
посетителя (для анонимных предложений
о приобретении и истории чтения).
AuthoritiesLog
COinSinOPACResults
Display856uAsImage
displayFacetCount
FacetLabelTruncationLength
FineNotifyAtCheckin
FrameworksLoaded
IntranetFavicon
— использовать изображение по адресу
________ на значок favicon для библиотечного
интерфейса (должно быть полным
URL-адресом, начинающимся с http://).
maxItemsInSearchResults
maxRecordsForFacets
numSearchRSSResults
OPACAllowUserToChooseBranch
OpacCloud
OPACDisplay856uAsImage
OpacFavicon
— использовать изображение по адресу
________ на значок favicon для электронного
каталога (должно быть полным URL-адресом,
начинающимся с http://).
OpacHiddenItems
OPACMySummaryHTML
— включить колонку «Ссылки» на вкладке
«моя сводка» (доступна, когда пользователь
вошел в электронный каталог) с следующим
HTML-кодом (оставьте пустым для отключения):
___________________
OPACNoResultsFound
— показывать этот HTML-код при отсутствии
результата поиска в электронном
каталоге: __________
OpacPrivacy
— запретить
посетителям самостоятельно выбирать
параметры конфиденциальности для их
истории чтения. Это также требует
задействовать «opacreadinghistory» и
«AnonymousPatron»
OpacPublic
— разрешить
быть открытым электронному каталогу
на АБИС Коха. Частный электронный
каталог требует аутентификации перед
доступом к электронному каталогу.
printcirculationslips
SelfCheckHelpMessage
SelfCheckTimeout
ShelfBrowserUsesCcode
ShelfBrowserUsesHomeBranch
ShelfBrowserUsesLocation
ShowReviewer
StaffAuthorisedValueImages
TraceCompleteSubfields
TraceSubjectSubdivisions
UseAuthoritiesForTracings
UseControlNumber
Version
WaitingNotifyAtCheckin
BorrowersLog
— записывать
в журнал
изменения в записях посетителей.
CataloguingLog
— не
записывать
в журнал
любые изменения относительно
библиографических или экземплярных
записей. Поскольку это происходит
также при каждой выдаче или возвращении
книги, не рекомендуется задействовать
этот параметр.
FinesLog
— записывать
в журнал
когда просроченные штрафы взимаются
или автоматически прощены.
IssueLog
— записывать
в журнал
когда экземпляры выдаются.
LetterLog
— записывать
в журнал
когда отправляется автоматическое
сообщение с претензией.
ReturnLog
— записывать
в журнал
при возврате экземпляров.
SubscriptionLog
— записывать
в журнал
когда сериальные издания добавляются,
удаляются или изменяются.
Внешний
вид
AuthorisedValueImages
BiblioDefaultView
— по умолчанию, показывать библиотечные
записи в
простой форме.
DisplayOPACiconsXSLT
hidelostitems
LibraryName
— показывать __________ в качестве названия
библиотеки в электронном каталоге.
OpacAddMastheadLibraryPulldown
OPACBaseURL
— ЭК располагается по адресу
http://_______________ (это необходимо корректно
заполнить для правильной работы RSS,
unAPI и поисковых плагинов)
opaccolorstylesheet
opaccredits
— включить следующий HTML-код в нижней
части всех страниц в электронном
каталоге: _____________
OPACDisplayRequestPriority
— не
показывать
посетителям уровень приоритета их
резервирований в ЭК.
opacheader
— включить следующий HTML-код в заголовке
всех страниц в ЭК: ________________
OpacHighlightedWords
opaclayoutstylesheet
OpacMaintenance
OpacMainUserBlock
OpacNav
OPACSearchForTitleIn
OPACShowCheckoutName
opacsmallimage
opacstylesheet
opacthemes
— использовать тему prog
для ЭК.
OPACURLOpenInNewWindow
OPACUserCSS
opacuserjs
OPACXSLTDetailsDisplay
— показывать страницы со сведениями
об экземплярах в электронном каталоге
в
нормальном виде.
OPACXSLTResultsDisplay
— показывать библиографические записи
на странице результата поиска ЭК в
нормальном виде.
Возможности
OpacAuthorities
opacbookbag
OpacBrowser
OPACFinesTab
OpacPasswordChange
OPACPatronDetails
opacreadinghistory
OPACShelfBrowser
OpacTopissue
opacuserlogin
RequestOnOpac
reviewson
suggestion
Правила
AnonSuggestions
OPACFineNoRenewals
OPACItemHolds
OpacRenewalAllowed
OPACViewOthersSuggestions
—
не
показывать
предложения о приобретении от других
посетителей в электронном каталоге.
SearchMyLibraryFirst
— не
ограничивать
результаты поисков библиотекой, в
которой посетитель зарегистрирован.
singleBranchMode
Приватность
EnableOpacSearchHistory
— сохранять
историю поисков посетителя в эллектронном
каталоге.
AddPatronLists
AutoEmailOpacUser
AutoEmailPrimaryAddress
autoMemberNum
BorrowerMandatoryField
— следующие столбцы базы данных должны
быть заполнены при регистрации
посетителя: surname|cardnumber
(отделять столбцы с помощью знака «|»)
borrowerRelationship
BorrowersTitles
checkdigit
EnhancedMessagingPreferences
— запретить
посетителям выбирать, какие сообщения
они получают и когда они их получают.
Обратите внимание, что это касается
только определённых видов сообщений.
ExtendedPatronAttributes
intranetreadinghistory
MaxFine
memberofinstitution
minPasswordLength
— пароли
входа в Коха для персонала и посетителей
должны состоять из не менее 3
символов.
NotifyBorrowerDeparture
patronimages
PatronsPerPage
SMSSendDriver
— использовать
драйвер «SMS::Send::_______» для отсылки
SMS-сообщений.
uppercasesurnames
Возможности
NoZebra
NoZebraIndexes
OpacGroupResults
QueryAutoTruncate
QueryFuzzy
QueryRemoveStopwords
QueryStemming
QueryWeightFields
TraceCompleteSubfields
TraceSubjectSubdivisions
Отображение
результатов
defaultSortField
defaultSortOrder
displayFacetCount
FacetLabelTruncationLength
maxItemsInSearchResults
maxRecordsForFacets
numSearchResults
OPACdefaultSortField
OPACdefaultSortOrder
OPACItemsResultsDisplay
OPACnumSearchResults
Поисковая
форма
AdvancedSearchTypes
expandedSearchOption
opacSerialDefaultTab
OPACSerialIssueDisplayCount
RenewSerialAddsSuggestion
RoutingListAddReserves
RoutingSerials
StaffSerialIssueDisplayCount
SubscriptionHistory
Appearance
Display856uAsImage
intranet_includes
intranetcolorstylesheet
IntranetFavicon
IntranetmainUserblock
IntranetNav
— использовать изображение по адресу
________ на значок
favicon
для библиотечного интерфейса (должно
быть полным URL-адресом, начинающимся
с http://).
intranetstylesheet
IntranetUserCSS
intranetuserjs
StaffAuthorisedValueImages
staffClientBaseURL
template
XSLTDetailsDisplay
XSLTResultsDisplay
yuipath
Options
HidePatronName
intranetbookbag
viewISBD
viewLabeledMARC
viewMARC
ILS-DI
ILS-DI
ILS-DI:AuthorizedIPs
OAI-PMH
OAI-PMH
OAI-PMH:archiveID
OAI-PMH:ConfFile
OAI-PMH:MaxCount
Посетители
и
оборот
Комментарии
Регулирование
комментариев
посетителей
.
Импорт посетителей
Импортирование
данных о
посетителях
. Основной
инструмент
миграции
посетителей.
Оповещения
Определение
оповещений
(предупредительные
сообщения,
которые
печатаются
или
высылаются
по электронной
почте при
просрочках
и т.п.)
.
Включатели
оповещений/статусов просрочек
Установка
включателей
оповещений/статусов
для
просроченных
экземпляров
.
Создатель билетов
посетителей
Создание
пригодных
для печати
билетов
посетителей
.
Посетители
(анонимизация, массовое удаление)
Удаление
старых
заемщиков
и анонимизация
истории
оборота
(очистка
истории
чтения
заемщика)
.
Метки
Регулирование
читательских
меток .
Загрузка изображений
посетителей
Загрузка
изображений
посетителей
пакетом
или же
по одному
за раз
.
Дополнительные
инструменты
Календарь
Определение
дней когда
библиотека
закрыта .
Возможны
уникальные
и повторяющиеся
(каждую
неделю или
год)
праздники,
индивидуально
для каждого
подразделения.
Профили форматирования
CSV
Управление
профилями
экспорта
в CSV
.
Средство просмотра
протоколов
Просмотр
протоколов
системы
для операций
в каждом
модуле.
Новости
Написание
новостей
как для
интерфейса
библиотекаря
та для
общедоступного
электронного
каталога.
Планировщик задач
Планирование
задач на
выполнение
.
Каталог
Пакетное удаление
экземпляров
Удаление
группы
экземпляров
.
Пакетное изменение
экземпляров
Изменение
группы
экземпляров
.
Экспорт
библиографических записей и единиц
хранения
Экспортирование
библиографической
информации
и данных
про единицы
хранения
.
Имеющиеся
фонды/инвентаризация
Выполнение
инвентаризации
(переучёта)
Вашего
каталога.
Создатель наклеек
Создание
пригодных
для печати
наклеек и
штрих-кодов
из данных
каталога
. Этот
инструмент
пока плохо
работает
с
кириллическими
текстами
на наклейках
(проблема
в сторонней
pdf-библиотеке),
если же
использовать
только
числовые
и «латинские»
данные то
проблема
снимается.
Быстрый создатель
наклейки на корешок
Введите
штрих-код
для создания
подходящей
для печати
наклейки
на корешок.
Для
использования
со
специализированными
принтерами
наклеек.
Заготовка
МАРК-записей для импорта
Заготавливаем
МАРК-записи
в хранилище.
Управление
заготовленными МАРК-записями
Управление
заготовленными
МАРК-записями,
в
частности
проведение
или
отмена
импорта.
Кроме
этого
есть
ещё
более
надёжный
инструмент
миграции
для
командной
строки
(bulkmarcimport.pl).
9