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