Перегляд вихідного коду сторінки Встановлення Koha з джерела на ОС Debian

Розглядається встановлення АБІС Koha серії 3.4 з джерельних кодів. Опис, в основному взятий з http://wiki.koha-community.org/wiki/Category:Installation з доповненнями.

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
  sudo locale
у виводі повинно бути

 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 update-locale LANG=uk_UA.UTF-8

== Користувач для Koha ==

Додаємо користувача

(нижче замість „АдміністраторСистемиKoha“ вводимо своє)

 sudo adduser АдміністраторСистемиKoha

Деколи група автоматично не створюється — тоді потрібно ще

 sudo addgroup АдміністраторСистемиKoha
 sudo adduser АдміністраторСистемиKoha АдміністраторСистемиKoha

Командою visudo відкриваємо для редагування файл привілеїв адміністратора і надаємо їх користувачу АдміністраторСистеми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“

===  Перлівські модулі ===

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

 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 (вводимо пароль користувача АдміністраторСистемиKoha)         

 su АдміністраторСистемиKoha
 cd ~/

== Отримання Koha ==

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

3) Логічне посилання на теку

Зручно мати логічне посилання на теку з Koha

 rm ~/koha/koha.local;ln -s ~/koha/koha-3.04.00.000 ~/koha/koha.local

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

Утворюємо базу даних 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

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

У теці Koha виконати

 ~/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 має бути найнижче)

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

Команда

 ~/koha/koha.local/koha_perl_deps.pl -c -u -m

видасть список відсутніх модулів та модулів, які необхідно оновити.

Вам необхідно знайти та встановити ці модулі (ймовірно, що список буде порожнім, оскільки всі необхідні пакунки повинні згадуватися у цьому керівництві вище).

Відсутні та модулі новіших версій шукайте у гілці Debian unstable або ж в 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) ['''koha3admin'''] 

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) ['''koha3admin'''] 

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) ['''koha3admin'''] 

Please specify the password of the user that owns the
database to be used by Koha (default from environment) ['''koha3gfhjkm'''] 

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) ['''koha3admin'''] 

Please specify the Zebra database password (default from environment) ['''koha3gfhjkm'''] 

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 виводить список усіх параметрів.

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

(тут не повинно бути помилок чи зауважень)

 make test

(тут вискакує багацько помилок, але згідно розсилань це лиш проблема тестувальника, нехтуємо)

!! тут зявляються результати тестування — більшість мають проходити успішно (ок), на незначні зауваження (згідно росзсилань) не звертаємо уваги

 sudo make install

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

Від встановлювача було прохання додати наступне до змінних оточення, отож додаємо до /etc/environment два рядки

 export KOHA_CONF=/etc/koha3/koha-conf.xml
 export PERL5LIB=/usr/share/koha3/lib

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

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 127.0.0.1:80>
 ...
 ServerName koha.xatahost.com:80
 ...
 <VirtualHost 127.0.0.1:8888>
 ...
 ServerName koha.xatahost.com:8888


4)    Перезапускаємо веб-сервер Apache 2
 
 sudo /etc/init.d/apache2 restart

== Сервер Zebra ==

Для запуску 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

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

Відкрити файл /etc/cron.d/koha та вставити наступне

 # Змінні оточення, що використовуються сценаріями Koha
 KOHA_CONF=/etc/koha3/koha-conf.xml
 KOHAPATH=/usr/share/koha3
 PERL5LIB=$KOHAPATH/lib

 # Завдання для cron
 1 * * * * koha $KOHAPATH/bin/migration_tools/rebuild_zebra.pl -a -b -z 2>&1 > /dev/null

== Запуск веб-встановлювача ==

У веб-оглядачі вводимо адресу нашого сервера

 http://localhost:8888