Як встановити Zammad 2.0 на Ubuntu 16.04 LTS

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

Передумови

• Свіжий Vultr Ubuntu 16.04 LTS екземпляр сервера 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 8

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

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

sudo apt install -y openjdk-8-jdk

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

java -version

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

openjdk version "1.8.0_131"
OpenJDK Runtime Environment (build 1.8.0_131-8u131-b11-2ubuntu1.16.04.3-b11)
OpenJDK 64-Bit Server VM (build 25.131-b11, 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 для надання функції пошуку. В Ubuntu 16.04 ви можете встановити останню стабільну версію Elasticsearch 5 за допомогою офіційного репозиторія Elasticsearch DEB, як показано нижче.

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

sudo apt install -y wget
wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -

Потім встановіть apt-transport-httpsпакет.

sudo apt install -y apt-transport-https

Збережіть визначення репозиторію в /etc/apt/sources.list.d/elastic-5.x.list.

echo "deb https://artifacts.elastic.co/packages/5.x/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-5.x.list

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

sudo apt update -y
sudo apt install -y elasticsearch

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

sudo systemctl daemon-reload
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.service

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

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

Перш за все, переконайтеся, що екземпляр сервера використовує UTF-8локаль, інакше PostgreSQL неможливо встановити.

locale

Якщо ви знайшли будь-які параметри мовного стандарту, крім en_US.UTF-8, вам потрібно переключитися на цю мову, як показано нижче.

sudo apt install -y locales
sudo locale-gen en_US.UTF-8
echo "LANG=en_US.UTF-8" | sudo tee /etc/default/locale

Переконавшись, що місцевий стандарт правильний, завантажте офіційне репо Zammad DEB.

wget -qO- https://dl.packager.io/srv/zammad/zammad/key | sudo apt-key add -
sudo wget -O /etc/apt/sources.list.d/zammad.list https://dl.packager.io/srv/zammad/zammad/stable/installer/ubuntu/16.04.repo

Встановіть Zammad і всі необхідні залежності за допомогою APT.

sudo apt update -y
sudo apt 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/sites-available/zammad.conf

Знайдіть лінію.

 server_name localhost;

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

server_name helpdesk.example.com;

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

:wq!

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

sudo systemctl restart nginx.service

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

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

sudo apt install -y policycoreutils
sestatus

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

sudo apt install -y selinux selinux-basics selinux-utils selinux-policy-ubuntu setools
sudo setsebool httpd_can_network_connect on -P

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

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

sudo ufw app list
sudo ufw allow OpenSSH
sudo ufw allow in "Nginx Full"
sudo ufw enable

Крок 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 і запросити представників служби підтримки клієнтів. Дякую, що прочитали.