Обговорення:Встановлення Koha з репозитарію на ОС Debian: відмінності між версіями
Dubyk (обговорення | внесок) |
Dubyk (обговорення | внесок) Немає опису редагування |
||
| Рядок 77: | Рядок 77: | ||
Перевірити поточний часовий пояс. |
Перевірити поточний часовий пояс. |
||
timedatectl |
|||
<syntaxhighlight lang="bash"> |
|||
timedatectl |
|||
</syntaxhighlight> |
|||
Для України рекомендується: |
Для України рекомендується: |
||
timedatectl set-timezone Europe/Kyiv |
|||
<syntaxhighlight lang="bash"> |
|||
timedatectl set-timezone Europe/Kyiv |
|||
</syntaxhighlight> |
|||
=== Перевірка === |
=== Перевірка === |
||
timedatectl |
|||
<syntaxhighlight lang="bash"> |
|||
timedatectl |
|||
</syntaxhighlight> |
|||
У полі '''Time zone''' повинно бути |
У полі '''Time zone''' повинно бути |
||
Europe/Kyiv |
|||
<syntaxhighlight lang="text"> |
|||
Europe/Kyiv |
|||
</syntaxhighlight> |
|||
== Локалі == |
== Локалі == |
||
| Рядок 103: | Рядок 95: | ||
Перевірити поточні локалі. |
Перевірити поточні локалі. |
||
locale |
|||
<syntaxhighlight lang="bash"> |
|||
locale |
|||
</syntaxhighlight> |
|||
Якщо локалі ще не створені, виконати |
Якщо локалі ще не створені, виконати |
||
dpkg-reconfigure locales |
|||
<syntaxhighlight lang="bash"> |
|||
dpkg-reconfigure locales |
|||
</syntaxhighlight> |
|||
Рекомендується увімкнути |
Рекомендується увімкнути |
||
en_US.UTF-8 UTF-8 |
|||
<syntaxhighlight lang="text"> |
|||
uk_UA.UTF-8 UTF-8 |
|||
uk_UA.UTF-8 UTF-8 |
|||
</syntaxhighlight> |
|||
Локаль за замовчуванням |
Локаль за замовчуванням |
||
en_US.UTF-8 |
|||
<syntaxhighlight lang="text"> |
|||
en_US.UTF-8 |
|||
</syntaxhighlight> |
|||
=== Перевірка === |
=== Перевірка === |
||
locale |
|||
<syntaxhighlight lang="bash"> |
|||
locale |
|||
</syntaxhighlight> |
|||
== Ім'я сервера == |
== Ім'я сервера == |
||
| Рядок 136: | Рядок 118: | ||
Перевірити поточне ім'я сервера. |
Перевірити поточне ім'я сервера. |
||
hostnamectl |
|||
<syntaxhighlight lang="bash"> |
|||
hostnamectl |
|||
</syntaxhighlight> |
|||
При необхідності змінити його. |
При необхідності змінити його. |
||
hostnamectl set-hostname koha |
|||
<syntaxhighlight lang="bash"> |
|||
hostnamectl set-hostname koha |
|||
</syntaxhighlight> |
|||
Якщо використовується доменне ім'я, рекомендується одразу встановити повне ім'я сервера, наприклад |
Якщо використовується доменне ім'я, рекомендується одразу встановити повне ім'я сервера, наприклад |
||
koha.example.org |
|||
<syntaxhighlight lang="text"> |
|||
koha.example.org |
|||
</syntaxhighlight> |
|||
=== Перевірка === |
=== Перевірка === |
||
hostname -f |
|||
<syntaxhighlight lang="bash"> |
|||
hostname -f |
|||
</syntaxhighlight> |
|||
== Файл hosts == |
== Файл hosts == |
||
| Рядок 162: | Рядок 136: | ||
Відкрити файл |
Відкрити файл |
||
mc -e /etc/hosts |
|||
<syntaxhighlight lang="bash"> |
|||
mc -e /etc/hosts |
|||
</syntaxhighlight> |
|||
Приклад |
Приклад |
||
127.0.0.1 localhost |
|||
<syntaxhighlight lang="text"> |
|||
127.0. |
127.0.1.1 koha.example.org koha |
||
127.0.1.1 koha.example.org koha |
|||
::1 localhost ip6-localhost ip6-loopback |
|||
::1 localhost ip6-localhost ip6-loopback |
|||
</syntaxhighlight> |
|||
=== Перевірка === |
=== Перевірка === |
||
hostname -f |
|||
<syntaxhighlight lang="bash"> |
|||
ping -c4 localhost |
|||
hostname -f |
|||
ping -c4 localhost |
|||
</syntaxhighlight> |
|||
== Синхронізація часу == |
== Синхронізація часу == |
||
| Рядок 186: | Рядок 154: | ||
Перевірити стан служби синхронізації часу. |
Перевірити стан служби синхронізації часу. |
||
systemctl status systemd-timesyncd |
|||
<syntaxhighlight lang="bash"> |
|||
systemctl status systemd-timesyncd |
|||
</syntaxhighlight> |
|||
Якщо служба не запущена |
Якщо служба не запущена |
||
systemctl enable systemd-timesyncd |
|||
<syntaxhighlight lang="bash"> |
|||
systemctl |
systemctl restart systemd-timesyncd |
||
systemctl restart systemd-timesyncd |
|||
</syntaxhighlight> |
|||
=== Перевірка === |
=== Перевірка === |
||
timedatectl |
|||
<syntaxhighlight lang="bash"> |
|||
timedatectl |
|||
</syntaxhighlight> |
|||
У полі |
У полі |
||
System clock synchronized |
|||
<syntaxhighlight lang="text"> |
|||
System clock synchronized |
|||
</syntaxhighlight> |
|||
повинно бути |
повинно бути |
||
yes |
|||
<syntaxhighlight lang="text"> |
|||
yes |
|||
</syntaxhighlight> |
|||
== Встановлення додаткових пакетів == |
== Встановлення додаткових пакетів == |
||
| Рядок 219: | Рядок 177: | ||
Встановити пакети, які знадобляться під час налаштування сервера. |
Встановити пакети, які знадобляться під час налаштування сервера. |
||
apt install -y \ |
|||
<syntaxhighlight lang="bash"> |
|||
apt-transport-https \ |
|||
apt install -y \ |
|||
ca-certificates \ |
|||
apt-transport-https \ |
|||
curl \ |
|||
ca-certificates \ |
|||
wget \ |
|||
gnupg \ |
|||
lsb-release \ |
|||
gnupg \ |
|||
software-properties-common \ |
|||
lsb-release \ |
|||
mc \ |
|||
software-properties-common \ |
|||
htop \ |
|||
iotop \ |
|||
iftop \ |
|||
tree \ |
|||
zip \ |
|||
unzip \ |
|||
rsync \ |
|||
cron \ |
|||
certbot |
|||
cron \ |
|||
certbot |
|||
</syntaxhighlight> |
|||
=== Перевірка === |
=== Перевірка === |
||
mc |
|||
<syntaxhighlight lang="bash"> |
|||
htop |
|||
mc |
|||
htop |
|||
</syntaxhighlight> |
|||
Програми повинні запускатися без помилок. |
Програми повинні запускатися без помилок. |
||
Версія за 15:58, 6 липня 2026
Встановлення та початкове налаштування 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.
...