Обговорення:Встановлення Koha з репозитарію на ОС Debian: відмінності між версіями

Матеріал з Koha Ukraine Wiki
Перейти до навігації Перейти до пошуку
Немає опису редагування
Рядок 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">
en_US.UTF-8 UTF-8
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.0.1 localhost
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 enable systemd-timesyncd
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 \
curl \
wget \
wget \
gnupg \
lsb-release \
gnupg \
software-properties-common \
lsb-release \
mc \
software-properties-common \
mc \
htop \
htop \
iotop \
iotop \
iftop \
iftop \
tree \
tree \
zip \
zip \
unzip \
unzip \
rsync \
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.

...