Встановлення АБІС Koha 3 альфа/бета/RC1/STABLE на сервер Linux Debian Etch

Усі команди необхідно встановлювати від користувача з привілеями sudo або ж безпосередньо з адміністраторського облікового запису root.

Дивимося сторінку Де взяти Дебіен.

Тут розглянемо варіант встановлення базової системи з допомогою невеличкого образу диску debian-40r8-i386-netinst.iso (біля 160 Мб).

Отож, звантажуємо його та записуємо на компакт-диск.

Дещо про вимоги до сервера є тут, дивіться також Nabble-Koha

Перед встановленням у BIOS-і виставляємо завантаження зі CD. Заодно пошукайте опцію автовключення сервера після відключення та включення електроживлення.

Завантажуємося зі CD і далі уважно відповідаємо на питання:

• boot: installgui (просто Enter у цьому місці запустить встановлювач у текстовому режимі)
• мова: українська (при цьому автоматично вибереться локаль з кодуванням utf-8, що необхідно для Koha)
• розкладка: українська
• мережа - вручну
  • ip: ___.___.___.___
  • маска: 255.255.255.0
  • шлюз: ___.___.___.___
  • DNS: ___.___.___.___
• назва комп'ютера __________
• домен _________________________
• розбиття жорсткого диску на розділи - вручну
  • 1 розділ: / - корінь системи, обов'язковий (цей розділ має бути завантажувальним)
  • 2 розділ: swap - для свапу (розмір ~= подвійному обсягу ОП), дуже рекомендується
• паролі (вибирайте складні, про паролі тут)
  • головного адміністратора root: _________
  • користувач (адміністратор системи/відповідальна особа), напр. sysadmin та його пароль _________
• дзеркало (для довстановлення та оновлення Дебіен): Україна
  • у нас доступні два дзеркала - debian.osdn.org.ua та debian.org.ua - вибирайте доступніше
• проксі: _________________________ (якщо використовується, то вказуйте повний шлях, напр. http://192.168.12.1:3128/)
• … очікуємо на зв'язок з дзеркалом (отримання оновленого списку пакунків) - час на звантаження біля 6 Майт чи ~30 хв. як у мене (по Alt-F4 можна підглядати за процесом)
• участь у опитуванні - рекомендую так - це збільшить імовірність, що у подальших випусках Дебіан необхідні нам пакунки будуть на 1 CD чи DVD
• вибір ПЗ: стандартна система (без графічної оболонки можна обійтися хіба що маєте швидкий Інтернет)
• … знову очікуємо - у мене звантажувалося біля 70 Мб і зайняло декілька годин (ймовірно, це були оновлення безпеки від часу випуску debian-40r3-i386-netinst.iso)
• перемикач кирилиця/латиниця: Ctrl-Shift
• тимчасовий перемикач: права клавіша Windows.
• менеджер завантаження ОС Grub встановлюємо у головний завантажувальний запис
• ВСЕ - виймаємо диск, йде перезавантаження - базова система встановлена.

Після перезавантаження входимо до системи під користувачем sysadmin.

Встановимо сервер ssh

apt-get install ssh

Для операції встановлення потрібні привілеї головного адміністратора root, вводимо команду su та на запит пароль.

apt-get install sudo (sudo)

Командою visudo відкриваємо для редагування файл привілеїв адміністратора і надаємо їх користувачу sysadmin, додавши у кінці файлу рядок

sysadmin ALL=(ALL) ALL

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

Після встановлення маємо дистанційний доступ до цього сервера для нашого користувача sysadmin (з можливістю через sudo виконувати адмін-функції)

• у Windows з допомогою PuTTY
• у Linux/Unix з допомогою команди ssh sysadmin@IPАДРЕСА

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

sudo apt-get install mc genisoimage screen bzip2 unzip links phpmyadmin

або ж по окремо

sudo apt-get install mc - файловий менеджер Midnight Commander

sudo apt-get install genisoimage - для монтування iso-образів

sudo apt-get install screen - можливість мати у консольному доступі декілька віртуальних екранів з фоновим виконанням (що найкорисніше, наприклад, при діал-ап-доступі тощо)

sudo apt-get install bzip2 unzip - корисні архіватори

sudo apt-get install links - текстовий консольний броузер (для перевірок/навігації зсередини сервера)

sudo apt-get install phpmyadmin - керування базами даних MySQL через веб-інтерфейс

Вводимо команду

 locale

Має бути UTF-8

Якщо ні, то налаштовуємо локаль

 sudo dpkg-reconfigure locales

(якщо не встановлена, то встановлюємо sudo apt-get install locales)

До файлу /etc/apt/sources.list додаємо наступні рядки

# Index Data
deb http://ftp.indexdata.dk/debian etch main
deb-src http://ftp.indexdata.dk/debian etch main

Щоб не було постійних попереджень що пакунки з Index Data не підписані, реєструємо ключ, виконавши

mkdir ~/keys; wget -O ~/keys/indexdata.key http://ftp.indexdata.dk/debian/indexdata.asc; sudo apt-key add ~/keys/indexdata.key

та оновлюємо списки репозитарію

sudo apt-get update

Додаємо у '/etc/apt/sources.list':

# BackPorts
deb http://www.backports.org/debian/ etch-backports main contrib non-free

Виконуємо

mkdir ~/keys; wget -O ~/keys/backports.key http://www.backports.org/debian/archive.key; sudo apt-key add ~/keys/backports.key
sudo apt-get update

Це лише для випадку, якщо у Вас є компакт-диск(и) з репозитаріями (Debian,IndexData,BackPorts)

Для прикладу візьмемо 1-ший встановлювальний DVD з Дебіен

Копіюємо вміст диску до каталогу /mnt/debian-40r3-i386-DVD-1 і підключаємо (у файлі /etc/apt/sources/lists) додавши

deb file:///mnt/debian-40r3-i386-DVD-1 etch main contrib

Якщо ж маєте iso-образ цього диску і не хочете розпаковувати то попередньо зробіть таке Розмістіть файл за шляхом /mnt/debian-40r3-i386-DVD-1.iso, створіть теку /mnt/debian-40r3-i386-DVD-1 та додайте до /etc/fstab наступний рядок

/mnt/debian-40r3-i386-DVD-1.iso /mnt/debian-40r3-i386-DVD-1     iso9660 ro,loop,user,auto       0       0

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

sudo apt-get install at apache2 git git-core make gcc daemon mysql-server

або ж по окремо

sudo apt-get install at
sudo apt-get install apache2

sudo apt-get install git
sudo apt-get install git-core

sudo apt-get install make
sudo apt-get install gcc
sudo apt-get install daemon
sudo apt-get install mysql-server

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

sudo apt-get install libcgi-session-perl libnet-ldap-perl libmail-sendmail-perl libsocket6-perl libterm-readkey-perl libio-pty-perl liblingua-stem-perl liblist-moreutils-perl liblocale-gettext-perl libcurses-perl libevent-perl libgtk-perl libunix-syslog-perl libdbd-mysql-perl libdbi-perl libclass-factory-util-perl libclass-accessor-perl libdate-calc-perl libdate-manip-perl libdate-ical-perl libdatetime-format-mail-perl libdatetime-format-strptime-perl libdatetime-format-w3cdtf-perl libdatetime-locale-perl libdatetime-perl libdatetime-timezone-perl libtime-duration-perl libtime-format-perl libtimedate-perl libpdf-api2-perl libgd-barcode-perl libtext-charwidth-perl libtext-wrapi18n-perl libxml-dom-perl libxml-dumper-perl libxml-namespacesupport-perl libxml-parser-perl libxml-perl libxml-simple-perl libxml-regexp-perl libxml-xslt-perl libxml-libxml-perl libxml-libxslt-perl libyaml-syck-perl libtest-warn-perl libtest-nowarnings-perl libtest-longstring-perl libclass-accessor-chained-perl libclass-returnvalue-perl liblocale-po-perl libmodule-pluggable-perl libhtml-scrubber-perl libemail-simple-perl libtime-piece-perl libemail-abstract-perl libmime-lite-perl

або ж по окремо

sudo apt-get install libcgi-session-perl  
sudo apt-get install libnet-ldap-perl
sudo apt-get install libmail-sendmail-perl
sudo apt-get install libsocket6-perl
sudo apt-get install libterm-readkey-perl
sudo apt-get install libio-pty-perl
sudo apt-get install liblingua-stem-perl
sudo apt-get install liblist-moreutils-perl
sudo apt-get install liblocale-gettext-perl
sudo apt-get install libcurses-perl
sudo apt-get install libevent-perl
sudo apt-get install libgtk-perl
sudo apt-get install libunix-syslog-perl
sudo apt-get install libdbd-mysql-perl
sudo apt-get install libdbi-perl
sudo apt-get install libclass-factory-util-perl
sudo apt-get install libclass-accessor-perl
sudo apt-get install libdate-calc-perl
sudo apt-get install libdate-manip-perl
sudo apt-get install libdate-ical-perl
sudo apt-get install libdatetime-format-mail-perl
sudo apt-get install libdatetime-format-strptime-perl
sudo apt-get install libdatetime-format-w3cdtf-perl
sudo apt-get install libdatetime-locale-perl
sudo apt-get install libdatetime-perl
sudo apt-get install libdatetime-timezone-perl
sudo apt-get install libtime-duration-perl
sudo apt-get install libtime-format-perl
sudo apt-get install libtimedate-perl  
sudo apt-get install libpdf-api2-perl
sudo apt-get install libgd-barcode-perl
sudo apt-get install libtext-charwidth-perl
sudo apt-get install libtext-wrapi18n-perl  
sudo apt-get install libxml-dom-perl
sudo apt-get install libxml-dumper-perl
sudo apt-get install libxml-namespacesupport-perl
sudo apt-get install libxml-parser-perl
sudo apt-get install libxml-perl
sudo apt-get install libxml-simple-perl
sudo apt-get install libxml-regexp-perl
sudo apt-get install libxml-xslt-perl
sudo apt-get install libxml-libxml-perl
sudo apt-get install libxml-libxslt-perl
sudo apt-get install libyaml-syck-perl      
sudo apt-get install libtest-warn-perl
sudo apt-get install libtest-nowarnings-perl
sudo apt-get install libtest-longstring-perl
sudo apt-get install libclass-accessor-chained-perl
sudo apt-get install libclass-returnvalue-perl
sudo apt-get install liblocale-po-perl
sudo apt-get install libmodule-pluggable-perl
sudo apt-get install libhtml-scrubber-perl
sudo apt-get install libemail-simple-perl
sudo apt-get install libtime-piece-perl
sudo apt-get install libemail-abstract-perl
sudo apt-get install libmime-lite-perl

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

sudo apt-get install idzebra-2.0 idzebra-2.0-common idzebra-2.0-doc idzebra-2.0-utils libidzebra-2.0 libidzebra-2.0-dev 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           libyaz            libyaz-dev

або ж по окремо

sudo apt-get install idzebra-2.0
sudo apt-get install idzebra-2.0-common
sudo apt-get install idzebra-2.0-doc
sudo apt-get install idzebra-2.0-utils
sudo apt-get install libidzebra-2.0
sudo apt-get install libidzebra-2.0-dev
sudo apt-get install libidzebra-2.0-mod-alvis
sudo apt-get install libidzebra-2.0-mod-grs-marc
sudo apt-get install libidzebra-2.0-mod-grs-regx
sudo apt-get install libidzebra-2.0-mod-grs-xml
sudo apt-get install libidzebra-2.0-mod-text
sudo apt-get install libidzebra-2.0-modules

sudo apt-get install yaz               (встановилася версія 3.0.26-1)
sudo apt-get install yaz-doc           (встановилася версія 3.0.26-1)
sudo apt-get install libyaz            (встановилася версія 2.1.54-1)
sudo apt-get install libyaz-dev        (встановилася версія 2.1.54-1)

Зауваження: для випадку 64-бітної архітектури у репозитарії IndexData не було відповідних пакунків, отож приходиться встановлювати вручну

mkdir ~/IndexData; cd ~/IndexData; wget http://ftp.indexdata.dk/pub/yaz/yaz-3.0.26.tar.gz; tar -xzf yaz-3.0.26.tar.gz; cd yaz-3.0.26; ./configure
make
sudo make install

mkdir ~/IndexData; cd ~/IndexData; wget http://ftp.indexdata.dk/pub/zebra/idzebra-2.0.28.tar.gz; tar -xzf idzebra-2.0.28.tar.gz; cd idzebra-2.0.28; ./configure
make
sudo make install

mkdir ~/IndexData; cd ~/IndexData; wget http://ftp.indexdata.dk/pub/pazpar2/pazpar2-1.0.7.tar.gz; tar -xzf pazpar2-1.0.7.tar.gz; cd pazpar2-1.0.7; ./configure
make
sudo make install

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

sudo apt-get install perl-tk libxml2 libxml2-dev libxml2-utils libxslt1-dev libxslt1.1 libmysqlclient15-dev libpcre3-dev libgd2-noxpm-dev

або ж по окремо

sudo apt-get install perl-tk

sudo apt-get install libxml2
sudo apt-get install libxml2-dev
sudo apt-get install libxml2-utils
sudo apt-get install libxslt1-dev
sudo apt-get install libxslt1.1

sudo apt-get install libmysqlclient15-dev

sudo apt-get install libgdbm-dev
sudo apt-get install libgd2-noxpm-dev

sudo apt-get install libpcre3-dev

Ці модулі відсутні у вище-згаданих репозитаріях Дебіен але є на CPAN.

Запускаємо оболонку CPAN:

cpan

При першому запуску у Вас буде запитано чи налаштувати доступ до CPAN вручну, - відповідаємо ні(no) і пробуємо автоналаштування.

Далі виконуємо команди у оболонці cpan, при цьому слідкуємо чи немає помилок, незадоволених залежностей:

install MARC::Charset

- тривала компіляція

install MARC::Record

install MARC::File::XML

install DublinCore::Record

install MARC::Crosswalk::DublinCore

install Net::Z3950::ZOOM

- якщо під час тесту виникають помилки, то встановлюємо примусово

force install Net::Z3950::ZOOM

install Algorithm::CheckDigits

install Biblio::EndnoteStyle

install PDF::API2

install Text::CSV

install Text::CSV_XS

install IO

install Storable

install POE

- довго виконуються тести

install HTML::Template::Pro

install PDF::Reuse

- також встановлюються допоміжні модулі

install GD

install Barcode::Code128

- якщо були помилки (повязані з fig,png), то, згідно згадки про це у курівництві, то цим можна знехтувати і виконати примусове встановлення

force install Barcode::Code128

install PDF::Reuse::Barcode

install Text::vFile::asData

install Data::ICal

install Schedule::At

install Test::Manifest

install XML::RSS

install DBD::mysql

- було багато помилок під час тестування, але компіляція виглядає успішною, нехтуємо і виконуємо примусове встановленн

force install DBD::mysql

install Text::Iconv

install SMS::Send

- також встановився Class::Adapter

install Params::Util

- можливо вже встановлено

install Email::Date

install Email::Date::Format

- можливо вже встановлено

Для виходу з оболонки CPAN натискаємо

q

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

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

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

Для виконання команд з правами адміністратора, — додаємо рядок

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

до файлу /etc/sudoers

Переходимо у середовище користувача АдміністраторСистемиKoha

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

(вводимо пароль користувача АдміністраторСистемиKoha, тут надалі пароль=ПарольАдміністратораСистемиKoha, обов’язково у Вашому встановленні використовуйте інший пароль)

cd ~/

У цьому керівництві розглядається встановлення Koha 3 RC1.

Хоча можете спробувати найсвіжішу розробницьку версію з репозитарію Git (для цього випадку шлях встановлення може різнитися). Отож, якщо не лякає нестабільність розроблювальної версії, то спершу необхідно зкофіґурувати git

sudo update-alternatives --config git

і вибрати scm

А далі отримати вихідні коди розробницької версії з репозитарію Git:

mkdir ~/koha; cd ~/koha
git clone git://git.koha.org/pub/scm/koha.git kohaclone
tar -cvf kohaclone.tar kohaclone/
bzip2 -f kohaclone.tar
cd kohaclone
git checkout -b myinstall origin

(див. також - http://wiki.koha.org/doku.php?id=en:development:git_usage)

А для отримання більш стабільної Koha 3.0 STABLE (або ж новішої версії), - звантажуємо її з http://download.koha.org та розпаковуємо

mkdir ~/koha; wget -O ~/koha/koha-3.00.00.tar.gz http://download.koha.org/koha-3.00.00.tar.gz; cd ~/koha; tar -xzf koha-3.00.00.tar.gz

(Нижче замість ПарольАдмінаMySQL(пароль адміна MySQL), Koha3(назва БД), КористувачБДKoha3(користувач БД), ПарольКористувачаБДKoha3(його пароль) вводимо своє)

• Оновити пароль для користувача root БД MySQL (можливо це зроблено при встановленні MySQL)

sudo mysqladmin password ПарольАдмінаMySQL

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

Утворюємо базу даних та привілеї користувачів щодо неї:

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

• Для підтримки UTF-8 у MySQL у файлі (в кінці) /etc/mysql/my.cnf має бути наступне

[mysql]
default-character-set=utf8
[mysqld]
init-connect = 'SET NAMES utf8'
default-character-set=utf8
character-set-server=utf8
collation-server=utf8_unicode_ci

Перезапускаємо сервер MySQL

sudo /etc/init.d/mysql restart

Переконуємося, що зміни внесені, виконавши

sudo mysql -uroot -pПарольАдмінаMySQL
show variables;
quit 

su koha3admin

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

~/koha/koha-3.00.00/misc/sax_parser_print.pl

Ви повинні побачити щось таке

XML::LibXML::SAX::Parser=HASH(0x81fe220)

Якщо ж є PurePerl чи Expat, то необхідно поправити файл /etc/perl/XML/SAX/ParserDetails.ini (запис щодо XML::LibXML::SAX::Parser має бути найнижче)

cd ~/koha/koha-3.00.00/
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 \
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]

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 [/usr/share/koha] 

/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 [koha] 

АдміністраторСистеми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 [koha] 

АдміністраторСистеми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]

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]

localhost

Please specify the port used to connect to the
DMBS [3306]

3306

Please specify the name of the database to be
used by Koha [koha] 

Koha3

Please specify the user that owns the database to be
used by Koha [kohaadmin] 

КористувачБДKoha3

Please specify the password of the user that owns the
database to be used by Koha [katikoan] 

ПарольКористувачаБД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]

yes

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, unimarc) [marc21]

unimarc

Koha supplies Zebra configuration files tuned for
searching either English (en) or French (fr) MARC
records.
Primary language for Zebra indexing (en, fr) [en]

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) [grs1]

grs1

Please specify Zebra database user [kohauser] 

КористувачZebra

Please specify the Zebra database password [zebrastripes] 

ПарольКористувача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]

yes

SRU Database host? [localhost] 

localhost

SRU port for bibliographic data? [9998] 

9998

SRU port for authority data? [9999] 

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? [no] 

yes

Zebra bibliographic server host? [localhost]

localhost

Zebra bibliographic port for PazPar2 to use? [11001]

11001

PazPar2 host? [localhost]

localhost

PazPar2 port? [11002]

11002

Would you like to run the database-dependent test suite? (no, yes) [no]

no

До речі, якщо Ви помилитеся, чи побачите наприкінці що ще не всі залежності задоволені, то можете поправити файл Makefile.PL, внісши в нього відповіді

Після завершення опитування Koha виводить список усіх параметрів (дивимося чи все добре)

AUTH_INDEX_MODE          grs1
DB_HOST                  localhost
DB_NAME                  Koha3
DB_PASS                  ПарольКористувачаБДKoha3
DB_PORT                  3306
DB_TYPE                  mysql
DB_USER                  КористувачБДKoha3 
INSTALL_BASE             /usr/share/koha3
INSTALL_MODE             standard
INSTALL_PAZPAR2          yes
INSTALL_SRU              yes
INSTALL_ZEBRA            yes
KOHA_GROUP               АдміністраторСистемиKoha
KOHA_INSTALLED_VERSION   3.00.00.107
KOHA_USER                АдміністраторСистемиKoha
MERGE_SERVER_HOST        localhost
MERGE_SERVER_PORT        11001
PATH_TO_ZEBRA            /usr/bin
PAZPAR2_HOST             localhost
PAZPAR2_PORT             11002
RUN_DATABASE_TESTS       no
ZEBRA_LANGUAGE           en
ZEBRA_MARC_FORMAT        unimarc
ZEBRA_PASS               ПарольКористувачаZebra
ZEBRA_SRU_AUTHORITIES_POR9999
ZEBRA_SRU_BIBLIOS_PORT   9998
ZEBRA_SRU_HOST           localhost
ZEBRA_USER               КористувачZebra

а також список усіх тек, куди передбачається встановлення

DOC_DIR                  /usr/share/koha3/doc
INTRANET_CGI_DIR         /usr/share/koha3/intranet/cgi-bin
INTRANET_TMPL_DIR        /usr/share/koha3/intranet/htdocs/intranet-tmpl
INTRANET_WWW_DIR         /usr/share/koha3/intranet/htdocs
KOHA_CONF_DIR            /etc/koha3
LOG_DIR                  /var/log/koha3
MAN_DIR                  /usr/share/koha3/man
MISC_DIR                 /usr/share/koha3/misc
OPAC_CGI_DIR             /usr/share/koha3/opac/cgi-bin
OPAC_TMPL_DIR            /usr/share/koha3/opac/htdocs/opac-tmpl
OPAC_WWW_DIR             /usr/share/koha3/opac/htdocs
PAZPAR2_CONF_DIR         /etc/koha3/pazpar2
PERL_MODULE_DIR          /usr/share/koha3/lib
SCRIPT_DIR               /usr/share/koha3/bin
SCRIPT_NONDEV_DIR        /usr/share/koha3/bin
ZEBRA_CONF_DIR           /etc/koha3/zebradb
ZEBRA_DATA_DIR           /var/lib/koha3/zebradb
ZEBRA_LOCK_DIR           /var/lock/koha3/zebradb
ZEBRA_RUN_DIR            /var/run/koha3/zebradb

Перевірте, що у виводі встановлювальника немає помилок чи згадки про незадоволені залежності.

make

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

make test

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

sudo make install

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

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

Заодно, при потребі, у цьому ж файлі прописуємо щось на зразок цього (згідно параметрів Вашої мережі)

export WEBSERVER_IP=192.168.12.229
export http_proxy="http://192.168.12.228:3128"
export ftp_proxy="http://192.168.12.228:3128"

Підключаємо до Apache2 конфігурацію для Koha

sudo ln -s /etc/koha3/koha-httpd.conf /etc/apache2/sites-available/Koha3
sudo a2ensite Koha3

Та задіюємо модуль Rewrite

sudo a2enmod rewrite

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

sudo a2enmod expires
sudo a2enmod deflate

Додаємо порти до /etc/apache2/ports.conf

Listen 8008
Listen 8888

А також підправляємо їх у файлі /etc/koha3/koha-httpd.conf на зразок

<VirtualHost 192.168.103.101:8008>
...
  ServerName koha3:8008
...
<VirtualHost 192.168.103.101:8888>
... 
  ServerName koha3:8888

Перезапускаємо веб-сервер Apache 2

sudo /etc/init.d/apache2 restart

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

http://192.168.103.101:8888

• Реєструємося (згадуємо логін АдміністраторСистемиKoha та пароль ПарольАдміністратораСистемиKoha)
• 1) Мова: uk-UA
• Бачимо, що усі залежності встановлені
• 2) Перевіряємо налаштування БД
• Перевірка з'єднання з БД Koha3
• 3) Підготовка до створення таблиць БД
• Йде створення таблиць - успішно?
• Базові налаштування
  • MARC-стандарт - Unimarc
  • Вибір налаштувань та зразкових даних для імпорту - вибираємо усе
  • Переконуємося, що нема помилок при імпорті
• Механізм індексування Nozebra (тобто усі таблиці у БД MySQL)
• Завершення

ВСЕ - КОХА ВСТАНОВЛЕНА