Обговорення:Встановлення 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;
• OPAC;
• службовий інтерфейс;
• HTTPS;
• SMTP;
• резервне копіювання.

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

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

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

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

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

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

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

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

<syntaxhighlight lang="bash"> apt update apt full-upgrade -y reboot </syntaxhighlight>

Перевірка

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

<syntaxhighlight lang="bash"> cat /etc/debian_version </syntaxhighlight>

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

Часовий пояс

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

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

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

<syntaxhighlight lang="bash"> timedatectl set-timezone Europe/Kyiv </syntaxhighlight>

Перевірка

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

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

<syntaxhighlight lang="text"> Europe/Kyiv </syntaxhighlight>

Локалі

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

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

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

<syntaxhighlight lang="bash"> dpkg-reconfigure locales </syntaxhighlight>

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

<syntaxhighlight lang="text"> en_US.UTF-8 UTF-8 uk_UA.UTF-8 UTF-8 </syntaxhighlight>

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

<syntaxhighlight lang="text"> en_US.UTF-8 </syntaxhighlight>

Перевірка

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

Ім'я сервера

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

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

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

<syntaxhighlight lang="bash"> hostnamectl set-hostname koha </syntaxhighlight>

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

<syntaxhighlight lang="text"> koha.example.org </syntaxhighlight>

Перевірка

<syntaxhighlight lang="bash"> hostname -f </syntaxhighlight>

Файл hosts

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

<syntaxhighlight lang="bash"> mc -e /etc/hosts </syntaxhighlight>

Приклад

<syntaxhighlight lang="text"> 127.0.0.1 localhost 127.0.1.1 koha.example.org koha

1 localhost ip6-localhost ip6-loopback

</syntaxhighlight>

Перевірка

<syntaxhighlight lang="bash"> hostname -f ping -c4 localhost </syntaxhighlight>

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

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

<syntaxhighlight lang="bash"> systemctl status systemd-timesyncd </syntaxhighlight>

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

<syntaxhighlight lang="bash"> systemctl enable systemd-timesyncd systemctl restart systemd-timesyncd </syntaxhighlight>

Перевірка

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

У полі

<syntaxhighlight lang="text"> System clock synchronized </syntaxhighlight>

повинно бути

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

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

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

<syntaxhighlight lang="bash"> 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 </syntaxhighlight>

Перевірка

<syntaxhighlight lang="bash"> mc htop </syntaxhighlight>

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

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

Примітка.

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

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

...