Установка OTRS на Ubuntu 22.04

OTRS — бесплатная open-source система управления заявками (Ticket Request System) для отслеживания IT-проблем и запросов. Написана на Perl и поддерживает несколько СУБД (PostgreSQL, MySQL/MariaDB и др.). OTRS предоставляет единый вход для пользователей, IT-персонала и внешних организаций и часто используется в службах поддержки и центрах обработки вызовов.

Кому полезно это руководство

• Системным администраторам и DevOps, которые разворачивают службу заявок.
• Командам техподдержки, которые хотят локально развернуть OTRS.
• Инженерам, которым нужен пошаговый чек-лист и рекомендации по безопасности.

Основные шаги (минимальная методология)

1. Подготовьте сервер и обновите пакеты.
2. Установите зависимости Perl, Apache и MariaDB.
3. Защитите и настройте MariaDB.
4. Создайте пользователя и распакуйте OTRS в /opt/otrs.
5. Проверьте модули Perl, установите права и подключите Apache.
6. Пройдите веб-инсталлятор и запустите демона OTRS.

Требования

• Сервер с Ubuntu 22.04.
• Доступ root или эквивалент sudo для выполнения команд.
• Резервное копирование важных данных перед изменением конфигураций.

Подготовка системы

Перед началом обновите пакеты:

apt-get update -y

Установка необходимых модулей Perl (включая модули для работы с БД и SSL):

apt install perl libapache2-mod-perl2 libdbd-mysql-perl libtimedate-perl libnet-dns-perl libnet-ldap-perl libio-socket-ssl-perl libpdf-api2-perl libdbd-mysql-perl libsoap-lite-perl libtext-csv-xs-perl libjson-xs-perl libapache-dbi-perl libxml-libxml-perl libxml-libxslt-perl libyaml-perl libarchive-zip-perl libcrypt-eksblowfish-perl libencode-hanextra-perl libmail-imapclient-perl libtemplate-perl libmoo-perl libauthen-ntlm-perl libjavascript-minifier-xs-perl libdbd-odbc-perl libcss-minifier-xs-perl libdbd-pg-perl libdatetime-perl -y

Важно: если на вашей системе уже установлены альтернативные версии модулей, проверяйте совместимость с OTRS.

Установка Apache и MariaDB

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

apt install apache2 mariadb-server mariadb-client -y

Запустите и включите автозагрузку сервисов:

systemctl start apache2 mariadb
systemctl enable apache2 mariadb

Защита MariaDB и базовая конфигурация

Запустите скрипт начальной защиты MariaDB:

mysql_secure_installation

Рекомендуемые ответы (если сервер новый):

Enter current password for root (enter for none):
Set root password? [Y/n]: N
Remove anonymous users? [Y/n]: Y
Disallow root login remotely? [Y/n]: Y
Remove test database and access to it? [Y/n]: Y
Reload privilege tables now? [Y/n]: Y

Затем откройте файл конфигурации MariaDB для тонкой настройки:

nano /etc/mysql/mariadb.conf.d/50-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

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

systemctl restart mariadb

Примечание: подберите innodb_buffer_pool_size согласно объёму оперативной памяти на сервере (обычно 60–80% от доступной памяти для выделенного БД-сервера).

Установка OTRS

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

useradd -r -m -d /opt/otrs -c "OTRS User" -s /usr/sbin/nologin otrs

Добавьте пользователя OTRS в группу веб-сервера:

usermod -aG www-data otrs

Скачайте OTRS Community Edition (пример версии в исходном руководстве):

wget https://otrscommunityedition.com/download/otrs-community-edition-6.0.35.tar.gz

Распакуйте в /opt/otrs:

tar xvfz otrs-community-edition-6.0.35.tar.gz -C /opt/otrs --strip-components=1

Установите владельца каталогов OTRS:

chown -R otrs:otrs /opt/otrs

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

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

Ожидаемый вывод показывает статус каждого модуля и версии. Модули, отмеченные как Not installed, либо опциональны, либо требуются для специфичных функций (например, DBD::Oracle — только для Oracle).

Создайте конфигурационный файл на основе примера и проверьте Perl-скрипты:

cp /opt/otrs/Kernel/Config.pm{.dist,}
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
perl /opt/otrs/bin/otrs.SetPermissions.pl

Настройка Apache для OTRS

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

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

Отключите сайт по умолчанию:

a2dissite 000-default.conf

Включите нужные модули Apache:

a2enmod perl version deflate filter headers

Установите правильные права веб-группы и перезапустите Apache:

/opt/otrs/bin/otrs.SetPermissions.pl --web-group=www-data
systemctl restart apache2

Проверить статус Apache:

systemctl status apache2

Доступ к веб-инсталлятору OTRS

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

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

Следуйте шагам установщика: соглашение с лицензией, выбор СУБД, ввод настроек MySQL/MariaDB, создание пользователя базы данных, системные настройки и при необходимости конфигурация SMTP.

После завершения инсталляции инсталлятор выдаст URL, логин и временный пароль. Перейдите по указанному URL для первого входа.

Решение распространённых проблем

Проблема: на дашборде отображается ошибка «OTRS Daemon not running». Решение — запустите демон и службу cron для пользователя otrs:

sudo -Hiu otrs /opt/otrs/bin/otrs.Daemon.pl start
cp /opt/otrs/var/cron/otrs_daemon{.dist,}
sudo -Hiu otrs /opt/otrs/bin/Cron.sh start

Затем обновите страницу — сообщение должно исчезнуть.

Дополнительные рекомендации по отладке:

• Проверяйте логи Apache (/var/log/apache2/error.log) и логи OTRS (/opt/otrs/var/log/).
• Если модуль Perl отсутствует, устанавливайте его через apt или CPAN, затем перезапускайте сервисы.
• При ошибках подключения к БД проверьте права пользователя и host (127.0.0.1 vs localhost).

Безопасность и соответствие требованиям приватности

Важно обеспечить безопасность сервера и соответствие законам о персональных данных:

• Запустите Apache через HTTPS (Let’s Encrypt или корпоративный сертификат). Откройте 443 и перенаправьте HTTP на HTTPS.
• Ограничьте доступ к административной панели по IP или через VPN.
• Храните резервные копии базы данных и файлов OTRS в зашифрованном хранилище.
• Минимизируйте привилегии учетной записи базы данных для приложения.
• Логи с персональными данными храните и удаляйте в соответствии с политикой хранения данных (GDPR/локальные правила).

Роль‑ориентированные чек-листы

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

• Убедиться, что сервер обновлён.
• Настроить брандмауэр и HTTPS.
• Назначить правильные права на /opt/otrs.

DBA:

• Настроить MariaDB: кодировка utf8, innodb параметры, бэкап.
• Создать пользователя БД с минимальными привилегиями.

DevOps:

• Автоматизировать деплой OTRS-версии.
• Настроить мониторинг демонов и логов.

Менеджер поддержки:

• Проверить доступность панелей агентов.
• Настроить почтовый шлюз для внешних писем.

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

• Веб-инсталлятор доступен по HTTPS и до него можно дойти с рабочего места.
• Все требуемые модули Perl пройдены проверкой otrs.CheckModules.pl.
• Apache работает, и OTRS отвечает на запросы без ошибок 500.
• Демон OTRS запущен, cron задания выполняются.
• Есть тестовый тикет, который проходит полный жизненный цикл (создание → назначение → решение → закрытие).

Альтернативы и сценарии, когда OTRS не подходит

• Если нужна SaaS‑решение с минимальным обслуживанием — рассмотрите облачные сервисы управления заявками.
• Для лёгких команд с простой маршрутизацией тикетов может быть удобнее система с современным интерфейсом и мобильными приложениями.
• OTRS лучше подходит для зрелых процессов ITSM; для небольших команд возможна избыточность функционала.

Полезные сниппеты и быстрый чек команд

Проверка статуса служб:

systemctl status apache2
systemctl status mariadb
sudo -Hiu otrs /opt/otrs/bin/otrs.Daemon.pl status

Запуск демона и cron:

sudo -Hiu otrs /opt/otrs/bin/otrs.Daemon.pl start
sudo -Hiu otrs /opt/otrs/bin/Cron.sh start

Применение прав:

/opt/otrs/bin/otrs.SetPermissions.pl --web-group=www-data

Небольшая диаграмма принятия решений развертывания

flowchart TD
  A[Готов ли сервер с Ubuntu 22.04?] -->|Нет| B[Обновите систему и подготовьте сервер]
  A -->|Да| C[Установить зависимости Perl]
  C --> D[Установить Apache и MariaDB]
  D --> E[Настроить MariaDB]
  E --> F[Распаковать OTRS в /opt/otrs]
  F --> G[Проверить модули и права]
  G --> H[Запустить веб-инсталлятор]
  H --> I[Завершить установку и запустить демоны]

Краткий глоссарий терминов

• OTRS — система управления заявками (ticketing).
• Демон — фоновый процесс, обслуживающий очередь задач OTRS.
• Cron — планировщик задач для периодических процессов.

Заключение

Поздравляю — вы успешно прошли через все шаги установки OTRS на Ubuntu 22.04: от подготовки системы и установки зависимостей до запуска веб-инсталлятора и решения распространённых проблем. Используйте чек-листы и рекомендации по безопасности для стабильной и безопасной эксплуатации.

Если вам нужно, могу помочь составить Ansible-плейбук для автоматизации развёртывания или проверить конфигурацию Apache/MariaDB по вашему окружению.

Сводка ключевых шагов и рекомендаций представлена выше.