Обговорення:Встановлення 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

Примітка.

У цьому розділі використовується офіційний репозиторій Koha.

Після виходу нових версій Debian або Koha адреса репозиторію чи спосіб підпису GPG-ключем можуть змінюватися. Перед виконанням команд бажано звірити їх з офіційною документацією Koha.

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

apt update
apt install -y curl gnupg ca-certificates

Створити каталог для ключів APT.

install -d -m755 /etc/apt/keyrings

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

curl -fsSL https://debian.koha-community.org/koha/gpg.asc \
| gpg --dearmor -o /etc/apt/keyrings/koha.gpg

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

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

Вміст файлу

Types: deb
URIs: https://debian.koha-community.org/koha
Suites: stable
Components: main
Signed-By: /etc/apt/keyrings/koha.gpg

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

apt update

Перевірка

apt policy koha-common

Повинна відображатися доступна версія Koha 26.05.

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

Встановити пакет Koha.

apt install -y koha-common

Під час встановлення будуть автоматично встановлені:

• Apache;
• MariaDB (якщо її ще не встановлено);
• Elasticsearch (залежно від пакунків репозиторію);
• Plack;
• усі необхідні Perl-модулі.

Перевірка

dpkg -l koha-common

Пакет повинен мати стан

ii

Основний файл налаштувань Koha

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

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

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

DOMAIN=".example.org"

OPACPORT="80"

INTRAPORT="8080"

USE_MEMCACHED="yes"

MEMCACHED_SERVERS="127.0.0.1:11211"

ZEBRA_MARC_FORMAT="UNIMARC"

ZEBRA_LANGUAGE="en"

ENABLE_SRU="yes"

USE_ELASTICSEARCH="yes"

Примітка.

Значення DOMAIN повинно відповідати доменному імені сервера.

Перевірка

Перевірити синтаксис файлу.

grep -v '^#' /etc/koha/koha-sites.conf | grep .

MariaDB

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

apt install -y mariadb-server

Запустити службу.

systemctl enable mariadb
systemctl restart mariadb

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

mysql_secure_installation

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

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

Перевірка

systemctl is-active mariadb

Повинно бути

active

Elasticsearch

Якщо пакет не встановлено автоматично

apt install -y elasticsearch

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

systemctl enable elasticsearch
systemctl restart elasticsearch

Перевірка

systemctl status elasticsearch

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

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

curl http://127.0.0.1:9200

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

Memcached

Встановити сервер кешування.

apt install -y memcached

Увімкнути службу.

systemctl enable memcached
systemctl restart memcached

Перевірка

systemctl is-active memcached

Повинно бути

active

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

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

library

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

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

koha-create --create-db library

Процес може тривати кілька хвилин.

Перевірка

koha-list

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

library

Apache

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

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

ls -l /etc/apache2/sites-enabled/

Повинні бути присутні конфігураційні файли бібліотеки.

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

systemctl restart apache2

Перевірка

systemctl status apache2

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

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

apachectl configtest

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

Syntax OK