Cách cài đặt Zammad 2.0 trên Ubuntu 16.04 LTS

• Điều kiện tiên quyết
• Bước 1: Thiết lập FQDN (tên miền đủ điều kiện)
• Bước 2: Cài đặt gói OpenJDK 8
• Bước 3: Cài đặt Elaticsearch 5 và plugin ánh xạ đính kèm
• Bước 4: Cài đặt Zammad 2.0
• Bước 5: Thiết lập quy tắc tường lửa và tường lửa
• Bước 6: Thiết lập hệ thống Zammad mới từ giao diện Web

Zammad là một hệ thống trợ giúp / bán vé nguồn mở được thiết kế cho các nhóm hỗ trợ khách hàng. Với Zammad, đại diện dịch vụ khách hàng có thể dễ dàng xử lý các truy vấn và khiếu nại của khách hàng từ nhiều kênh khác nhau, bao gồm web, biểu mẫu, email, trò chuyện, Twitter, Facebook, v.v.

Điều kiện tiên quyết

• Một tươi Vultr Ubuntu 16.04 LTS dụ máy chủ x64 với ít nhất 4GB bộ nhớ. Nói địa chỉ IP của nó là 203.0.113.1, và tên máy chủ của nó là helpdesk.
• Một miền được helpdesk.example.comcấu hình để trỏ đến phiên bản máy chủ được đề cập ở trên. Bạn có thể tìm hiểu thêm chi tiết về điều này trong một hướng dẫn khác của Vultr .
• Một người dùng sudo .
• Ví dụ máy chủ đã được cập nhật trạng thái ổn định mới nhất .
• Trong môi trường sản xuất, nên thiết lập một tệp hoán đổi để tối ưu hóa hiệu suất.

Bước 1: Thiết lập FQDN (tên miền đủ điều kiện)

Theo yêu cầu của Zammad, bạn cần thiết lập đúng FQDN trên phiên bản máy chủ của mình trước khi bạn có thể truy cập từ xa vào trang web Zammad.

Sử dụng vitrình soạn thảo văn bản để mở /etc/hoststệp.

sudo vi /etc/hosts

Chèn dòng sau trước bất kỳ dòng hiện có.

203.0.113.1 helpdesk.example.com helpdesk

Lưu và đóng.

:wq!

Sử dụng hostname -flệnh để xác nhận kết quả, nó sẽ trông như thế này.

helpdesk.example.com

Bước 2: Cài đặt gói OpenJDK 8

Theo yêu cầu của Zammad, bạn cần cài đặt Java trên cá thể máy chủ của mình trước khi có thể cài đặt và chạy Zammad.

Cài đặt bản phát hành ổn định mới nhất của OpenJDK 8.

sudo apt install -y openjdk-8-jdk

Đã cài đặt OpenJDK 8, bạn có thể xác minh kết quả.

java -version

Đầu ra sẽ như thế này.

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)

Cuối cùng, thiết lập JAVA_HOMEbiến môi trường.

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

Bước 3: Cài đặt Elaticsearch 5 và plugin ánh xạ đính kèm

Zammad sử dụng Elaticsearch để cung cấp chức năng tìm kiếm. Trên Ubuntu 16.04, bạn có thể cài đặt bản phát hành ổn định mới nhất của ElSTERearch 5 bằng cách sử dụng repo chính thức của ElSTERearch DEB như dưới đây.

Đầu tiên, tải xuống và cài đặt khóa ký công khai Elaticsearch 5.

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

Sau đó, cài đặt apt-transport-httpsgói.

sudo apt install -y apt-transport-https

Lưu định nghĩa kho lưu trữ vào /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

Next, install Elasticsearch 5.x using APT.

sudo apt update -y
sudo apt install -y elasticsearch

Finally, start the Elasticsearch service and make it automatically start on boot time.

sudo systemctl daemon-reload
sudo systemctl start elasticsearch.service
sudo systemctl enable elasticsearch.service

In addition, in order to allow Elasticsearch to index file attachments, you need to install the Elasticsearch mapper-attachments plugin as follows.

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

When asked to approve additional permissions, type "Y" and then press "Enter" to finish the installation.

Restart the Elasticsearch service to load the new plugin.

sudo systemctl restart elasticsearch.service

Step 4: Install Zammad 2.0

In order to facilitate the installation process, you can use the official Zammad DEB repo to install Zammad along with various dependencies, including Nginx, PostgreSQL and more, all at the same time.

First of all, make sure that the server instance is using a UTF-8 locale, otherwise PostgreSQL cannot be installed.

locale

If you find any locale settings other than en_US.UTF-8, then you need to switch to that locale as follows.

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

After ensuring the locale is correct, download the official Zammad DEB repo.

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

Install Zammad and all of the required dependencies using APT.

sudo apt update -y
sudo apt install -y zammad

Having Zammad successfully installed, the Zammad service will automatically get started. You can use the following command to confirm the Zammad service's status.

sudo systemctl status zammad.service

Its status will be active (running).

Next, use the following commands to make Zammad work with Elasticsearch and rebuild the index.

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

Add extra Elasticsearch index name space (optional).

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

Ignore common binary file types (optional).

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

Set the max attachment size (optional).

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

In order to allow users to remotely access Zammad, you need to modify the Zammad Nginx configuration file.

sudo vi /etc/nginx/sites-available/zammad.conf

Find the line.

 server_name localhost;

Replace localhost with the FQDN of your server instance.

server_name helpdesk.example.com;

Save and quit.

:wq!

Finally, restart the Nginx service to apply your modifications.

sudo systemctl restart nginx.service

Step 5: Setup SELinux and firewall rules

Use the following commands to determine the status of SELinux on your server instance.

sudo apt install -y policycoreutils
sestatus

If SELinux is enabled in the enforcing mode on your machine, you need to modify a SELinux rule as follows.

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

If SELinux is disabled or enabled in the permissive mode, ignore above modifications and move on.

You also need to modify UFW firewall rules as follows.

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

Step 6: Setup the new Zammad system from the Web interface

Point your favorite web browser to http://helpdesk.example.com, and then you will be brought into the Zammad getting started page.

Click the Setup new system button to move on.

In the Administrator Account window, input the administrator's first name, last name, email, and password (twice), and then click the Create button.

In the Organization window, input the organization name and the system URL http://helpdesk.example.com , upload your logo (if any), and then click the Next button.

In the Email Notification window, choose a proper email sending method, and then click the Continue button.

In the Connect Channels window, click the Skip button to finish the initial setup. All channels can be customized later.

That's all for setting up an operational Zammad ticketing system. Feel free to explore the Zammad interface and invite customer service representatives. Thanks for reading.