Установка OTRS CE на AlmaLinux 8

Скриншот интерфейса OTRS и логотип проекта

OTRS Community Edition (Open Source Trouble Ticket System) — бесплатный и открытый пакет для управления заявками и службой поддержки. Чаще всего используется в службах поддержки, колл‑центрах и командах ITSM. Приложение написано на языке Perl и обычно работает с MariaDB в качестве СУБД. ОTRS состоит из трёх основных компонентов: админ‑панели, портала агентов и портала клиентов, и включает механизмы миграции с популярных систем.

В этой статье показано, как установить OTRS Community Edition на AlmaLinux 8 шаг за шагом.

Что вам понадобится

Сервер с AlmaLinux 8.
Доступ root или привилегии sudo.
Подключение к интернету для скачивания пакетов и зависимостей.

Шаг 1 — Установка зависимостей

Перед началом установите EPEL и Powertools, а также базовые пакеты разработки и модули Perl.

Выполните:

dnf install epel-release -y   
dnf config-manager --set-enabled powertools

Затем установите дополнительные зависимости:

dnf install gcc expat-devel procmail mod_perl perl perl-core sharutils -y

После успешной установки зависимостей можно переходить дальше.

Шаг 2 — Установка Apache и MariaDB

Установите веб‑сервер и СУБД:

dnf install httpd mariadb-server -y

Запустите и включите службы при старте:

systemctl start httpd mariadb  
systemctl enable httpd mariadb

Проверьте статус служб командой systemctl status httpd и systemctl status mariadb.

Шаг 3 — Создание базы данных для OTRS

Сначала обеспечьте безопасность MariaDB и задайте root‑пароль:

mysql_secure_installation

Ответьте на вопросы утилиты (задать root‑пароль, удалить анонимных пользователей, запретить удалённый вход root, удалить тестовую базу и перезагрузить таблицы привилегий).

Затем войдите в оболочку MariaDB:

mysql -u root -p

Создайте базу данных и пользователя для OTRS (замените ‘password’ на надёжный пароль):

MariaDB [(none)]> CREATE DATABASE otrs character set UTF8 collate utf8_bin;  
MariaDB [(none)]> GRANT ALL PRIVILEGES ON otrs.* TO 'otrs'@'localhost' IDENTIFIED BY 'password';
MariaDB [(none)]> FLUSH PRIVILEGES;  
MariaDB [(none)]> EXIT;

Отредактируйте конфигурацию MariaDB для улучшения производительности. Откройте файл:

nano /etc/my.cnf.d/mariadb-server.cnf

Добавьте в секцию [mysqld]:

max_allowed_packet=256M
character-set-server=utf8
collation-server=utf8_general_ci
innodb_buffer_pool_size=4G
innodb_log_file_size=1G

Сохраните изменения и перезапустите службу:

systemctl restart mariadb

Важно: на тестовой ВМ уменьшите innodb_buffer_pool_size в соответствии с объёмом памяти.

Шаг 4 — Установка OTRS

Создайте системного пользователя для OTRS и добавьте его в группу Apache:

useradd otrs
usermod -G apache otrs

Скачайте последний релиз Community Edition (в примере 6.0.33):

wget https://otrscommunityedition.com/download/otrs-community-edition-6.0.33.zip

Распакуйте и переместите в /opt:

unzip otrs-community-edition-6.0.33.zip
mv otrs-community-edition-6.0.33 /opt/otrs

Проверьте наличие необходимых Perl‑модулей:

perl /opt/otrs/bin/otrs.CheckModules.pl

Установите недостающие модули через CPAN (пример):

cpan Date::Format  
cpan DateTime  
cpan DateTime::TimeZone  
cpan Mail::IMAPClient  
cpan Moo  
cpan Net::DNS  
cpan Template  
cpan Template::Stash::XS  
cpan XML::LibXML  
cpan YAML::XS

Примечание: на серверах с ограничённым доступом используйте локальный CPAN‑mirror или пакетные версии модулей.

Шаг 5 — Настройка OTRS

Скопируйте шаблон конфигурации и отредактируйте его:

cp /opt/otrs/Kernel/Config.pm.dist /opt/otrs/Kernel/Config.pm
nano /opt/otrs/Kernel/Config.pm

Задайте параметры подключения к базе данных:

# Имя базы данных
$Self->{Database} = 'otrs';

# Пользователь базы данных
$Self->{DatabaseUser} = 'otrs';

# Пароль пользователя базы данных
$Self->{DatabasePw} = 'password';

Отредактируйте Apache‑startup для Perl‑драйвера БД:

nano /opt/otrs/scripts/apache2-perl-startup.pl

Раскомментируйте строки:

use DBD::mysql ();
use Kernel::System::DB::mysql;

Проверьте синтаксис ключевых CGI‑скриптов OTRS:

perl -cw /opt/otrs/bin/cgi-bin/index.pl  
perl -cw /opt/otrs/bin/cgi-bin/customer.pl  
perl -cw /opt/otrs/bin/otrs.Console.pl

Установите корректные права:

/opt/otrs/bin/otrs.SetPermissions.pl

Шаг 6 — Конфигурация Apache для OTRS

Создайте символическую ссылку на конфигурацию:

ln -s /opt/otrs/scripts/apache2-httpd.include.conf /etc/httpd/conf.d/otrs.conf

Перезапустите Apache:

systemctl restart httpd
systemctl status httpd

Ожидаемый вывод службы httpd содержит строку Active: active (running).

Запустите демон OTRS от имени пользователя otrs:

sudo -u otrs /opt/otrs/bin/otrs.Daemon.pl start

Ожидаемый результат:

Manage the OTRS daemon process.

Daemon started

Шаг 7 — Веб‑инсталлятор

Откройте в браузере:

http://your-server-ip-address/otrs/installer.pl

На страницах мастера следуйте шагам: выбор лицензии, параметров БД (MySQL/MariaDB), системные настройки, почтовая конфигурация (можно пропустить), затем переход на страницу входа.

Страница мастера установки OTRS — начало

Принятие лицензионного соглашения в мастере

Выбор СУБД в мастере: MySQL

Настройка подключения к базе данных

Проверка подключения к базе данных прошла успешно

Шаги мастера — системные параметры

Настройка системных настроек

Пропуск почтовой конфигурации на этапе установки

Стартовая страница и ссылка на логин

Страница входа в OTRS

Панель администратора OTRS после входа

Критерии приёмки

Веб‑мастер установки доступен и переходит на страницу входа.
Агентская панель и портал клиента открываются и позволяют вход.
Создание и отображение тикета (тестовое) — успешно.
Логи Apache и OTRS не содержат критических ошибок.

Чеклист для ролей

Администратор сервера:

Проверить наличие обновлений и патчей системы.
Настроить резервное копирование /opt/otrs и дамп базы.
Настроить мониторинг служб (httpd, mariadb, otrs daemon).

DBA:

Настроить файлы дампов и репликацию (при необходимости).
Проверить параметры InnoDB и кодировку (utf8).

Служба поддержки / суперпользователь OTRS:

Создать первые группы и пользователей агентов.
Настроить очереди, шаблоны и SLA.

Резервное копирование и откат

Резервная стратегия:

Ежедневный дамп базы: mysqldump –single-transaction –quick otrs > otrs-YYYYMMDD.sql
Бэкап каталога /opt/otrs и конфигураций /etc/httpd/conf.d

План отката:

Остановить сервисы OTRS и Apache.
Восстановить файлы /opt/otrs из архивa.
Восстановить дамп базы в тестовую БД и проверить целостность.
Запустить сервисы и проверить работу.

Отладка и распространённые проблемы

Ошибки Perl‑модулей: запустите otrs.CheckModules.pl, затем установите недостающие модули.
Невозможно подключиться к базе: проверьте credentials в /opt/otrs/Kernel/Config.pm и файервол.
Проблемы с правами: запустите /opt/otrs/bin/otrs.SetPermissions.pl и проверьте владельца файлов.
Apache не запускается: проверьте /var/log/httpd/error_log и синтаксис конфигураций.

Инцидентный сценарий (Runbook)

Сценарий: OTRS недоступен для пользователей.

Проверить статус служб: systemctl status httpd mariadb
Проверить логи: journalctl -u httpd -n 200, tail -n 200 /var/log/otrs.log
Перезапустить службы последовательно: systemctl restart mariadb, systemctl restart httpd, sudo -u otrs /opt/otrs/bin/otrs.Daemon.pl restart
Если проблема в БД — восстановить из последнего успешного дампа в тестовой среде и проверить.

Когда OTRS не подходит

Вам нужна встроенная CMDB/ITAM с развитой интеграцией — есть более современное ПО.
Требуются облачные SaaS‑решения с нулевым администрированием и SLA провайдера.

Методология быстрой проверки работоспособности

Проверка веб‑интерфейса — доступность /otrs/installer.pl и /otrs/index.pl.
Создание тестового тикета с почты и через портал клиента.
Проверка отправки и приёма почты (если настроено).
Мониторинг базы данных на предмет блокировок и роста логов.

Факто‑бокс

Рекомендуемые ресурсы для небольшой команды: 2 CPU, 4–8 ГБ RAM, диск 50+ ГБ.
Официальная ветка примера: OTRS Community Edition 6.x.
Основные технологии: Perl, Apache, MariaDB.

Decision flow (выбор конфигурации)

flowchart TD
  A[Нужен локальный сервер?] -->|Да| B[AlmaLinux 8]
  A -->|Нет, хочу SaaS| C[Рассмотреть облачные решения]
  B --> D{Будет ли IMAP/POP?}
  D -->|Да| E[Настроить почтовые учётные записи]
  D -->|Нет| F[Пропустить почтовую конфигурацию]
  E --> G[Настроить cron и демоны]
  F --> G
  G --> H[Запустить веб‑мастер и проверить]

Тесты и критерии приёмки

Веб‑мастер доступен и успешно проходит шаги установки.
Агент может создать тикет и поменять статус.
Клиент получает уведомление по почте (если настроено).
Бэкап базы создаётся и может быть восстановлен.

Краткое объявление для команды (100–200 слов)

Установлен OTRS Community Edition на сервере AlmaLinux 8. Платформа развернута в /opt/otrs, база данных — MariaDB, веб‑сервер — Apache. Проведены базовые настройки, установлены Perl‑модули и настроены права. Просьба к администраторам: настроить HTTPS, интеграцию с корпоративной почтой и мониторинг. В ближайшие дни будет подготовлен план обучения агентов и миграции ветки тикетов. Для экстренных вопросов используйте канал поддержки и логируйте все операции по восстановлению.

Заключение

Поздравляем — вы успешно установили OTRS Community Edition на AlmaLinux 8. Дальше можно настраивать очереди, шаблоны, автоматизацию и интеграции. Если нужно — помогу с настройкой HTTPS, интеграцией почты или миграцией данных.

Важно: перед вводом в продакшн выполните стресс‑тест и настройте регулярные бэкапы.