Обговорення:Встановлення 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-репозиторіями.

<syntaxhighlight lang="bash"> apt update

apt install -y \ ca-certificates \ curl \ gnupg </syntaxhighlight>

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

<syntaxhighlight lang="bash"> wget -qO- https://debian.koha-community.org/koha/gpg.asc \ | gpg --dearmor \ -o /usr/share/keyrings/koha-keyring.gpg </syntaxhighlight>

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

<syntaxhighlight lang="bash"> mc -e /etc/apt/sources.list.d/koha.list </syntaxhighlight>

Вміст файлу

<syntaxhighlight lang="text"> deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] \ https://debian.koha-community.org/koha stable main </syntaxhighlight>

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

<syntaxhighlight lang="bash"> apt update </syntaxhighlight>

Перевірка

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

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

<syntaxhighlight lang="text"> https://debian.koha-community.org/koha </syntaxhighlight>

Встановлення 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>

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

Примітка.

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