Обговорення:Встановлення Koha з репозитарію на ОС Debian

Встановлення та початкове налаштування Koha 26.05 на Debian GNU/Linux 13 (Trixie)

Вступ

У статті описано встановлення автоматизованої бібліотечної інформаційної системи Koha 26.05 з офіційного репозиторію на Debian GNU/Linux 13 (Trixie).

Після виконання всіх кроків буде встановлено та налаштовано:

• Koha 26.05;
• MariaDB;
• Apache;
• Elasticsearch;
• Plack;
• електронний каталог;
• інтерфейс бібліотекаря;
• HTTPS;
• SMTP;
• резервне копіювання.

Інструкція розрахована на чисту інсталяцію Debian 13.

Усі команди виконуються від користувача root.

Мінімальні вимоги

Для невеликих бібліотек рекомендується:

Компонент	Мінімально	Рекомендовано
Процесор	2 ядра	4 ядра і більше
Оперативна пам'ять	4 ГБ	8 ГБ і більше
Системний диск	40 ГБ SSD	100 ГБ SSD і більше
База даних	MariaDB	MariaDB
Пошуковий рушій	Elasticsearch	Elasticsearch

Для середніх і великих бібліотек обсяг оперативної пам'яті та дискового простору слід збільшити відповідно до кількості бібліографічних записів, примірників та користувачів.

Підготовка системи

Оновити список пакетів та встановити всі доступні оновлення.

apt update
apt full-upgrade -y
reboot

Перевірка

Перевірити версію Debian.

cat /etc/debian_version

Повинна відображатися версія 13.x.

Часовий пояс

Перевірити поточний часовий пояс.

timedatectl

Для України рекомендується:

timedatectl set-timezone Europe/Kyiv

Перевірка

timedatectl

У полі Time zone повинно бути

Europe/Kyiv

Локалі

Перевірити поточні локалі.

locale

Якщо локалі ще не створені, виконати

dpkg-reconfigure locales

Рекомендується увімкнути

en_US.UTF-8 UTF-8
uk_UA.UTF-8 UTF-8

Локаль за замовчуванням

en_US.UTF-8

Перевірка

locale

Ім'я сервера

Перевірити поточне ім'я сервера.

hostnamectl

При необхідності змінити його.

hostnamectl set-hostname koha

Якщо використовується доменне ім'я, рекомендується одразу встановити повне ім'я сервера, наприклад

koha.example.org

Перевірка

hostname -f

Файл hosts

Відкрити файл

mc -e /etc/hosts

Приклад

127.0.0.1       localhost
127.0.1.1       koha.example.org koha

::1             localhost ip6-localhost ip6-loopback

Перевірка

hostname -f
ping -c4 localhost

Синхронізація часу

Перевірити стан служби синхронізації часу.

systemctl status systemd-timesyncd

Якщо служба не запущена

systemctl enable systemd-timesyncd
systemctl restart systemd-timesyncd

Перевірка

timedatectl

У полі

System clock synchronized

повинно бути

yes

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

Встановити пакети, які знадобляться під час налаштування сервера.

apt install -y \
apt-transport-https \
ca-certificates \
curl \
wget \
gnupg \
lsb-release \
software-properties-common \
mc \
htop \
iotop \
iftop \
tree \
zip \
unzip \
rsync \
cron \
certbot

Перевірка

mc
htop

Програми повинні запускатися без помилок.

Налаштування репозиторію Koha

Встановити пакети, необхідні для роботи з HTTPS-репозиторіями.

apt update

apt install -y \
ca-certificates \
curl \
gnupg

Імпортувати ключ репозиторію Koha.

wget -qO- https://debian.koha-community.org/koha/gpg.asc \
| gpg --dearmor \
-o /usr/share/keyrings/koha-keyring.gpg

Створити файл репозиторію.

mc -e /etc/apt/sources.list.d/koha.list

Вміст файлу

deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] \
https://debian.koha-community.org/koha stable main

Оновити список пакетів.

apt update

Перевірка

apt policy koha-common

У списку джерел пакетів повинен бути репозиторій

https://debian.koha-community.org/koha

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

Встановити Koha.

<syntaxhighlight lang="bash"> apt install -y koha-common </syntaxhighlight>

Під час встановлення буде створено користувача koha, каталоги програми та встановлено всі необхідні Perl-модулі. :contentReference[oaicite:1]{index=1}

Перевірка

<syntaxhighlight lang="bash"> koha-list </syntaxhighlight>

До створення першої бібліотеки команда нічого не виведе.

Це нормально.

MariaDB

Запустити сервер баз даних.

<syntaxhighlight lang="bash"> systemctl enable mariadb systemctl restart mariadb </syntaxhighlight>

Виконати початкове налаштування.

<syntaxhighlight lang="bash"> mysql_secure_installation </syntaxhighlight>

Рекомендується:

• встановити пароль користувача root;
• видалити анонімних користувачів;
• заборонити віддалений вхід користувача root;
• видалити тестову базу даних;
• перезавантажити таблиці привілеїв.

Перевірка

<syntaxhighlight lang="bash"> systemctl is-active mariadb </syntaxhighlight>

Повинно бути

<syntaxhighlight lang="text"> active </syntaxhighlight>

Створення бібліотеки

У прикладах використовується назва

<syntaxhighlight lang="text"> library </syntaxhighlight>

За потреби замініть її на власну.

Створити бібліотеку.

<syntaxhighlight lang="bash"> koha-create --create-db library </syntaxhighlight>

Під час створення буде:

• створено базу даних;
• створено користувача MariaDB;
• створено конфігурацію Apache;
• створено конфігурацію Plack;
• створено службові каталоги;
• згенеровано пароль адміністратора бази даних.

Перевірка

<syntaxhighlight lang="bash"> koha-list </syntaxhighlight>

Повинно відобразитися

<syntaxhighlight lang="text"> library </syntaxhighlight>

Пароль доступу до бази даних

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

Переглянути його можна у файлі

<syntaxhighlight lang="bash"> mc -e /etc/koha/sites/library/koha-conf.xml </syntaxhighlight>

Знайти рядок

<syntaxhighlight lang="xml"> <pass>...</pass> </syntaxhighlight>

Цей пароль знадобиться під час роботи веб-інсталятора.

Примітка.

Не змінюйте цей пароль вручну без необхідності.

Налаштування вебсерверу

Після створення бібліотеки Koha автоматично створює конфігураційні файли Apache.

Перевірити їх наявність.

   ls -l /etc/apache2/sites-available/

Повинні бути присутні файли

   library.conf
   library_ssl.conf

Увімкнути необхідні модулі Apache.

   a2enmod rewrite
   a2enmod headers
   a2enmod proxy
   a2enmod proxy_http
   a2enmod ssl
   a2enmod cgid

Перезапустити Apache.

   systemctl restart apache2

Перевірка

Перевірити конфігурацію.

   apachectl configtest

Повинно відобразитися

   Syntax OK

Перевірити стан служби.

   systemctl is-active apache2

Повинно бути

   active

Налаштування HTTPS

Встановити Certbot.

   apt install -y certbot python3-certbot-apache

Отримати сертифікат Let's Encrypt.

   certbot --apache

Під час налаштування:

• вказати адресу електронної пошти;
• погодитися з умовами використання;
• вибрати домен бібліотеки;
• дозволити автоматичне перенаправлення HTTP → HTTPS.

Перевірка

Відкрити у браузері

   https://library.example.org

та

   https://library.example.org:8080

Повинно відображатися захищене з'єднання.

Перевірити автоматичне оновлення сертифікатів.

   systemctl status certbot.timer

Повинно бути

   active (waiting)

Plack

Запустити Plack для бібліотеки.

   koha-plack --enable library

Перезапустити Plack.

   koha-plack --restart library

Перевірка

   koha-plack --status library

Повинно відобразитися

   Plack is enabled

Memcached

Якщо сервер Memcached ще не встановлено

   apt install -y memcached

Увімкнути автоматичний запуск.

   systemctl enable memcached
   systemctl restart memcached

Переконатися, що використання Memcached увімкнено у файлі

   mc -e /etc/koha/koha-sites.conf

Параметр

   USE_MEMCACHED="yes"

Перевірка

   systemctl is-active memcached

Повинно бути

   active

Elasticsearch

Перевірити роботу служби.

   systemctl is-active elasticsearch

Повинно бути

   active

Перевірити відповідь сервера.

   curl http://127.0.0.1:9200

Повинен відобразитися JSON із відомостями про Elasticsearch.

Побудувати пошукові індекси.

   koha-elasticsearch --rebuild -v -f library

Примітка.

Під час першого індексування великої бази даних процес може тривати тривалий час.

Перевірка

У журналі не повинно бути повідомлень про помилки.

Доступ до вебінсталятора

Після створення бібліотеки відкрити службовий інтерфейс.

   https://library.example.org:8080

Відобразиться майстер встановлення Koha.

Для підключення до бази даних використовуються параметри з файлу

   /etc/koha/sites/library/koha-conf.xml

Заповнити:

• Database name;
• Database user;
• Database password.

Після успішного підключення перейти до наступного кроку.

Початкове налаштування Koha

Під час роботи майстра рекомендується:

• встановити демонстраційні дані лише для тестового сервера;
• для робочого сервера не встановлювати приклади читачів, примірників та бібліографічних записів;
• вибрати формат MARC — UNIMARC;
• вибрати стандартні системні налаштування.

Після завершення інсталятора увійти до службового інтерфейсу під користувачем

   koha_admin

та паролем, який було задано під час встановлення.

Перевірка

Відкрити головну сторінку службового інтерфейсу.

Переконатися, що:

• відображається головне меню;
• відсутні повідомлення про помилки;
• працює пошук;
• відкривається модуль «Керування».

Завершення встановлення

Після завершення вебінсталятора рекомендується виконати кілька додаткових перевірок.

Перевірити служби

   systemctl status apache2
   systemctl status mariadb
   systemctl status memcached
   systemctl status elasticsearch

Усі служби повинні перебувати у стані active (running).

Перевірити бібліотеку

   koha-list

Повинна відображатися створена бібліотека.

Перевірити Plack

   koha-plack --status koha

Якщо використовується інша назва бібліотеки, замініть koha на власну.

Plack повинен бути увімкнений.

Перевірити вебінтерфейси

Відкрити у браузері:

   https://koha.example.org

та

   https://koha.example.org:8080

Повинні відкриватися відповідно:

• електронний каталог (OPAC);
• службовий інтерфейс Koha.

Перші кроки після встановлення

Після успішного встановлення рекомендується:

• створити резервну копію бази даних;
• налаштувати електронну пошту;
• перевірити створення резервних копій;
• створити додаткових адміністраторів;
• налаштувати бібліотеки, категорії читачів та правила користування;
• встановити логотип бібліотеки;
• налаштувати резервне копіювання сервера.

Корисні команди

Перелік бібліотек

   koha-list

Перезапустити Plack

   koha-plack --restart koha

Зупинити Plack

   koha-plack --stop koha

Запустити Plack

   koha-plack --start koha

Перебудувати індекси Elasticsearch

   koha-elasticsearch --rebuild -f -v koha

Перевірити конфігурацію Apache

   apachectl configtest

Переглянути журнали Apache

   journalctl -u apache2

Переглянути журнали MariaDB

   journalctl -u mariadb

Переглянути журнали Elasticsearch

   journalctl -u elasticsearch

Типові проблеми

Apache не запускається

Перевірити конфігурацію.

   apachectl configtest

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

   systemctl restart apache2

MariaDB не запускається

Переглянути журнал.

   journalctl -u mariadb -n 100

Elasticsearch недоступний

Перевірити службу.

   systemctl status elasticsearch

Перевірити відповідь сервера.

   curl http://127.0.0.1:9200

Не відкривається службовий інтерфейс

Перевірити Apache.

   systemctl status apache2

Перевірити Plack.

   koha-plack --status koha

Перевірити журнали.

   journalctl -u apache2 -n 100

Оновлення системи

Для оновлення Debian

   apt update
   apt full-upgrade

Для оновлення Koha використовується стандартний механізм оновлення пакетів Debian.

Перед оновленням рекомендується створити резервну копію бази даних та каталогу

   /etc/koha

Наступні статті

Після встановлення рекомендується ознайомитися з такими статтями Wiki:

• Оновлення Koha.
• Резервне копіювання Koha.
• Перенесення Koha на інший сервер.
• Налаштування електронної пошти.
• Оптимізація продуктивності.
• HTTPS та сертифікати Let's Encrypt.
• Elasticsearch.
• Plack.
• Cron-завдання.