Як встановити Zammad 2.0 на CentOS 7

Zammad — це служба підтримки та продажу квитків з відкритим кодом, розроблена для команд підтримки клієнтів. За допомогою Zammad представники служби підтримки клієнтів можуть легко впоратися із запитами та скаргами клієнтів із різних каналів, включаючи Інтернет, форми, електронну пошту, чат, Twitter, Facebook тощо.

Передумови

• Свіжий Vultr CentOS екземпляр сервера 7 x64 з по крайней мере 4 Гб оперативної пам'яті. Скажімо, його IP-адреса – це 203.0.113.1, а його ім’я хоста – helpdesk.
• Домен, helpdesk.example.comналаштований для вказівки на згаданий вище екземпляр сервера. Ви можете дізнатися більше про це в іншому підручнику Vultr .
• Користувач sudo .
• Екземпляр сервера оновлено до останнього стабільного стану .
• У виробничому середовищі рекомендується налаштувати файл підкачки для оптимізації продуктивності.

Крок 1. Налаштуйте FQDN (повне доменне ім’я)

Відповідно до вимог Zammad, вам потрібно правильно налаштувати FQDN на вашому екземплярі сервера, перш ніж ви зможете віддалено отримати доступ до сайту Zammad.

Використовуйте viтекстовий редактор, щоб відкрити /etc/hostsфайл.

sudo vi /etc/hosts

Вставте наступний рядок перед будь-якими наявними рядками.

203.0.113.1 helpdesk.example.com helpdesk

Збережіть і вийдіть.

:wq!

Використовуйте hostname -fкоманду для підтвердження результату, який буде виглядати так.

helpdesk.example.com

Крок 2: Встановіть пакети OpenJDK 1.8

Відповідно до вимог Zammad, вам потрібно встановити Java на екземпляр сервера, перш ніж ви зможете встановити та запустити Zammad.

Встановіть останню стабільну версію OpenJDK 1.8.

sudo yum install -y java-1.8.0-openjdk-devel

Встановивши OpenJDK 1.8, ви можете перевірити результат.

java -version

Вихід буде виглядати так.

openjdk version "1.8.0_144"
OpenJDK Runtime Environment (build 1.8.0_144-b01)
OpenJDK 64-Bit Server VM (build 25.144-b01, mixed mode)

Нарешті, налаштуйте JAVA_HOMEзмінну середовища.

echo "JAVA_HOME=$(readlink -f /usr/bin/java | sed "s:bin/java::")" | sudo tee -a /etc/profile
source /etc/profile

Крок 3: Встановіть Elasticsearch 5 і плагін для вкладень

Zammad використовує Elasticsearch для забезпечення функції пошуку. На CentOS 7 ви можете встановити останню стабільну версію Elasticsearch 5 за допомогою офіційного репозиторія Elasticsearch YUM, як показано нижче.

Спочатку встановіть відкритий ключ підпису Elasticsearch 5.

sudo rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch

Потім налаштуйте репо Elasticsearch YUM.

cat <<EOF | sudo tee -a /etc/yum.repos.d/elasticsearch.repo
[elasticsearch-5.x]
name=Elasticsearch repository for 5.x packages
baseurl=https://artifacts.elastic.co/packages/5.x/yum
gpgcheck=1
gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
enabled=1
autorefresh=1
type=rpm-md
EOF

Далі встановіть Elasticsearch за допомогою YUM.

sudo yum install -y elasticsearch

Нарешті, запустіть службу Elasticsearch і змусьте її автоматично запускатися під час завантаження.

sudo systemctl start elasticsearch.service
sudo systemctl enable elasticsearch.service

Крім того, щоб дозволити Elasticsearch індексувати вкладені файли, вам потрібно встановити mapper-attachmentsплагін Elasticsearch .

sudo /usr/share/elasticsearch/bin/elasticsearch-plugin install mapper-attachments

Коли вас попросять затвердити додаткові дозволи, введіть " Y", а потім натисніть " Enter", щоб завершити встановлення.

Перезапустіть службу Elasticsearch, щоб завантажити новий плагін.

sudo systemctl restart elasticsearch

Крок 4: Встановіть Zammad 2.0

Щоб полегшити процес встановлення, ви можете використовувати офіційне репозиторію Zammad YUM, щоб одночасно встановити Zammad разом із різними залежностями, включаючи Nginx, PostgreSQL тощо.

Завантажте офіційне репо Zammad YUM.

sudo wget -O /etc/yum.repos.d/zammad.repo https://dl.packager.io/srv/zammad/zammad/stable/installer/el/7.repo

Встановіть Zammad і всі необхідні залежності.

sudo yum install -y zammad

Після успішного встановлення Zammad служба Zammad розпочнеться автоматично. Ви можете використовувати наступну команду, щоб підтвердити статус служби Zammad.

sudo systemctl status zammad.service

Статус Заммада буде active (running).

Далі скористайтеся наведеними нижче командами, щоб змусити Zammad працювати з Elasticsearch та перебудувати індекс.

sudo zammad run rails r "Setting.set('es_url', 'http://localhost:9200')"
sudo zammad run rake searchindex:rebuild

Додайте додатковий простір імен індексу Elasticsearch (необов’язково).

sudo zammad run rails r "Setting.set('es_index', Socket.gethostname + '_zammad')"

Ігноруйте типові двійкові файли (необов’язково).

sudo zammad run rails r "Setting.set('es_attachment_ignore', [ '.png', '.jpg', '.jpeg', '.mpeg', '.mpg', '.mov', '.bin', '.exe', '.box', '.mbox' ] )"

Встановіть максимальний розмір вкладеного файлу (необов’язково).

sudo zammad run rails r "Setting.set('es_attachment_max_size_in_mb', 50)"

Щоб надати користувачам віддалений доступ до Zammad, вам потрібно змінити файл конфігурації Zammad Nginx.

sudo vi /etc/nginx/conf.d/zammad.conf

Знайдіть цей рядок.

 server_name localhost;

Замініть localhostна FQDN вашого екземпляра сервера.

server_name helpdesk.example.com;

Збережіть і вийдіть.

:wq!

Нарешті, перезапустіть службу Nginx, щоб застосувати свої зміни.

sudo systemctl restart nginx.service

Крок 5: Налаштуйте SELinux і правила брандмауера

Використовуйте наступні команди, щоб визначити статус SELinux на вашому сервері.

sudo yum install -y policycoreutils
sestatus

Якщо SELinux увімкнено в enforcingрежимі на вашому комп’ютері, вам потрібно змінити правило SELinux наступним чином.

sudo yum install -y policycoreutils policycoreutils-python selinux-policy-devel
sudo setsebool httpd_can_network_connect on -P

Якщо SELinux вимкнено або ввімкнено в permissiveрежимі, ігноруйте вищезгадані зміни та рухайтеся далі.

Вам також потрібно змінити правила брандмауера, як показано нижче.

sudo firewall-cmd --zone=public --permanent --add-service=http
sudo firewall-cmd --zone=public --permanent --add-service=https
sudo firewall-cmd --reload

Крок 6: Налаштуйте нову систему Zammad з веб-інтерфейсу

Наведіть свій улюблений веб-браузер на http://helpdesk.example.com, і ви потрапите на Zammad getting startedсторінку.

Натисніть Setup new systemкнопку, щоб перейти далі.

У Administrator Accountвікні введіть ім’я, прізвище, адресу електронної пошти та пароль (двічі) адміністратора, а потім натисніть Createкнопку.

У Organizationвікні введіть назву організації та системну URL-адресу http://helpdesk.example.com, завантажте свій логотип (якщо є), а потім натисніть Nextкнопку.

У Email Notificationвікні виберіть потрібний спосіб надсилання електронної пошти, а потім натисніть Continueкнопку.

У Connect Channelsвікні натисніть Skipкнопку, щоб завершити початкове налаштування. Усі канали можна буде налаштувати пізніше.

Це все для налагодження оперативної системи продажу квитків Zammad. Не соромтеся вивчати інтерфейс Zammad і запросити представників служби підтримки клієнтів. Дякую, що прочитали.