Обговорення:Встановлення 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 |
Для середніх і великих бібліотек обсяг оперативної пам'яті та дискового простору слід збільшити відповідно до кількості бібліографічних записів, примірників та користувачів.
Підготовка системи
Оновити список пакетів та встановити всі доступні оновлення.
<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.
...