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

Матеріал з Koha Ukraine Wiki
Перейти до навігації Перейти до пошуку

Встановлення та початкове налаштування 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

Встановити пакети, необхідні для роботи з HTTPS-репозиторіями. 

apt update

apt install -y \
ca-certificates \
curl \
gnupg

Імпортувати ключ репозиторію Koha. 

wget -qO- https://debian.koha-community.org/koha/gpg.asc \
| gpg --dearmor \
-o /usr/share/keyrings/koha-keyring.gpg

Створити файл репозиторію. 

mc -e /etc/apt/sources.list.d/koha.list

Вміст файлу 

deb [signed-by=/usr/share/keyrings/koha-keyring.gpg] \
https://debian.koha-community.org/koha stable main

Оновити список пакетів. 

apt update

Перевірка

apt policy koha-common

У списку джерел пакетів повинен бути репозиторій 

https://debian.koha-community.org/koha

Встановлення Koha

Встановити Koha.

<syntaxhighlight lang="bash"> apt install -y koha-common </syntaxhighlight>

Під час встановлення буде створено користувача koha, каталоги програми та встановлено всі необхідні Perl-модулі. :contentReference[oaicite:1]{index=1}

Перевірка

<syntaxhighlight lang="bash"> koha-list </syntaxhighlight>

До створення першої бібліотеки команда нічого не виведе.

Це нормально.

MariaDB

Запустити сервер баз даних.

<syntaxhighlight lang="bash"> systemctl enable mariadb systemctl restart mariadb </syntaxhighlight>

Виконати початкове налаштування.

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

Рекомендується:

  • встановити пароль користувача root;
  • видалити анонімних користувачів;
  • заборонити віддалений вхід користувача root;
  • видалити тестову базу даних;
  • перезавантажити таблиці привілеїв.

Перевірка

<syntaxhighlight lang="bash"> systemctl is-active mariadb </syntaxhighlight>

Повинно бути

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

Створення бібліотеки

У прикладах використовується назва

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

За потреби замініть її на власну.

Створити бібліотеку.

<syntaxhighlight lang="bash"> koha-create --create-db library </syntaxhighlight>

Під час створення буде:

  • створено базу даних;
  • створено користувача MariaDB;
  • створено конфігурацію Apache;
  • створено конфігурацію Plack;
  • створено службові каталоги;
  • згенеровано пароль адміністратора бази даних.

Перевірка

<syntaxhighlight lang="bash"> koha-list </syntaxhighlight>

Повинно відобразитися

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

Пароль доступу до бази даних

Під час встановлення Koha автоматично генерує пароль користувача бази даних.

Переглянути його можна у файлі

<syntaxhighlight lang="bash"> mc -e /etc/koha/sites/library/koha-conf.xml </syntaxhighlight>

Знайти рядок

<syntaxhighlight lang="xml"> <pass>...</pass> </syntaxhighlight>

Цей пароль знадобиться під час роботи веб-інсталятора.

Примітка.

Не змінюйте цей пароль вручну без необхідності.

Отримано з http://wiki.koha.org.ua/index.php?title=Обговорення:Встановлення_Koha_з_репозитарію_на_ОС_Debian&oldid=9309