Instal Sistem Tiket Zammad di Ubuntu 20.04

Selamat datang di tutorial kami tentang cara menginstal sistem tiket Zammad di Ubuntu 20.04. Menurut halaman dokumentasi Zammad, “Zammad adalah open source helpdesk/sistem dukungan pelanggan berbasis web dengan banyak fitur untuk mengelola komunikasi pelanggan melalui beberapa saluran seperti telepon, facebook, twitter, chat dan email”.

Baca tentang fitur sistem Zammad Ticketing di halaman fiturnya, tautan tersedia di bawah ini.

Fitur sistem Tiket Zammad

Instal Sistem Tiket Zammad di Ubuntu 20.04

Prasyarat

Ada sejumlah persyaratan yang harus dipenuhi sistem Anda (saat tulisan ini dibuat) sebelum Anda dapat menginstal sistem Zammad Ticketing di Ubuntu 20.04.

Persyaratan Perangkat Lunak

  1. Ruby 2.6.6 untuk Zammad v3.4.1+: Zammad ditulis dalam Ruby dan Java dan karenanya Ruby diperlukan.
  2. Sistem Manajemen Database Relasional (RDBMS) untuk menyimpan konten. Sistem RDMS yang didukung;
    • MySQL 5.6+
    • MariaDB 10.0+
    • PostgreSQL 9.1+ (disarankan dan didukung secara default).
  3. Reverse Proxy untuk mengirimkan konten statis aplikasi Anda:
    • Nginx 1.3+
    • Apache 2.2+
  4. Elasticsearch (opsional tetapi sangat disarankan) untuk membuat pencarian lebih cepat dan untuk mendukung fitur lanjutan seperti laporan atau pencarian dengan isi lampiran email. Zammad v3.4+ kompatibel dengan Elasticsearch 5.5–7.7.

Persyaratan Perangkat Keras

Silakan merujuk ke halaman persyaratan perangkat keras Zammad.

Instal Sistem Tiket Zammad di Ubuntu 20.04

Konfigurasikan Lokal di Ubuntu

Dalam tutorial ini, kita akan menginstal Zammad dengan PostgreSQL yang didukung secara default.

Dengan demikian, jika Anda menggunakan backend database PostgreSQL, Anda harus mengaktifkan lokal UTF-8.

Untuk memeriksa apakah UTF-8 lokal diaktifkan, jalankan locale perintah dari terminal seperti yang ditunjukkan di bawah ini.

locale
LANG=en_US.UTF-8 LANGUAGE= LC_CTYPE="en_US.UTF-8" LC_NUMERIC="en_US.UTF-8" LC_TIME="en_US.UTF-8" LC_COLLATE="en_US.UTF-8" LC_MONETARY="en_US.UTF-8" LC_MESSAGES="en_US.UTF-8" LC_PAPER="en_US.UTF-8" LC_NAME="en_US.UTF-8" LC_ADDRESS="en_US.UTF-8" LC_TELEPHONE="en_US.UTF-8" LC_MEASUREMENT="en_US.UTF-8" LC_IDENTIFICATION="en_US.UTF-8" LC_ALL=

Jika dari output di atas Anda tidak melihat garis,

LANG=en_US.UTF-8

Anda perlu membuat dan memperbarui lokal.

locale-gen en_US.UTF-8
update-locale LANG=en_US.UTF-8

Ini akan memperbarui file /etc/default/locale dengan variabel lingkungan LANG yang disetel.

Instal Elasticsearch di Ubuntu

Zammad v3.4+ kompatibel dengan Elasticsearch 5.5–7.7. Oleh karena itu, mari kita instal Elasticsearch 7.7 di Ubuntu.

Instal kunci penandatanganan repositori Elasticsearch;

wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch --no-check-certificate | sudo apt-key add -

Instal repo Elasticsearch;

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

Instal Elasticsearch 7.7 di Ubuntu;

apt update
apt install elasticsearch=7.7.1

Instal Sistem Tiket Zammad di Ubuntu 20.04

Instal daftar repo Zammad di Ubuntu

Instal kunci penandatanganan GPG repo;

wget -qO- https://dl.packager.io/srv/zammad/zammad/key | sudo apt-key add -

Instal repositori Zammad;

curl -so /etc/apt/sources.list.d/zammad.list https://dl.packager.io/srv/zammad/zammad/stable/installer/ubuntu/20.04.repo

Perbarui cache paket;

apt update

Selanjutnya, instal sistem tiket Zammad di Ubuntu 20.04 dan semua paket lain yang diperlukan. Perintah di bawah ini menginstal Zammad 3.6.0, yang merupakan rilis stabil saat ini pada tulisan ini?

apt install zammad

Saat instalasi selesai, Anda akan melihat output seperti itu;

... Setting default Logging to file, set via "zammad config:set RAILS_LOG_TO_STDOUT=true" if you want to log to STDOUT! # Starting Zammad # Creating webserver bootstart Synchronizing state of nginx.service with SysV service script with /lib/systemd/systemd-sysv-install. Executing: /lib/systemd/systemd-sysv-install enable nginx # Restarting webserver nginx #################################################################################### Add your fully qualified domain name or public IP to servername directive of nginx, if this installation is done on a remote server. You have to change: /etc/nginx/sites-available/zammad.conf and restart nginx process. Otherwise just open http://localhost/ in your browser to start using Zammad. ####################################################################################...
Mengelola Layanan Zammad
Zammad
systemctl status zammad systemctl stop zammad systemctl start zammad systemctl restart zammad
Hanya server aplikasi web
systemctl status zammad-web systemctl stop zammad-web systemctl start zammad-web systemctl restart zammad-web
Hanya proses pekerja
systemctl status zammad-worker systemctl stop zammad-worker systemctl start zammad-worker systemctl restart zammad-worker
Hanya server websocket
systemctl status zammad-websocket systemctl stop zammad-websocket systemctl start zammad-websocket systemctl restart zammad-websocket

Konfigurasikan Elasticsearch untuk Zammad

Selanjutnya, konfigurasikan engine pencari Elasticsearch untuk Zammad.

Menjalankan Elasticsearch

Kami telah menginstal Elasticsearch 7.7.1. Dengan demikian, Anda dapat memulai dan mengaktifkannya untuk berjalan pada boot sistem dengan menjalankan perintah di bawah ini;

systemctl enable --now elasticsearch

Elasticsearch sekarang berjalan dengan pengaturan default.

Anda dapat memverifikasi dengan menjalankan perintah di bawah ini;

curl localhost:9200
{ "name" : "ubuntu20", "cluster_name" : "elasticsearch", "cluster_uuid" : "zALXjPYuQ9O4l2woJjHmFA", "version" : { "number" : "7.7.1", "build_flavor" : "default", "build_type" : "deb", "build_hash" : "ad56dce891c901a492bb1ee393f12dfff473a423", "build_date" : "2020-05-28T16:30:01.040088Z", "build_snapshot" : false, "lucene_version" : "8.5.1", "minimum_wire_compatibility_version" : "6.8.0", "minimum_index_compatibility_version" : "6.0.0-beta1" }, "tagline" : "You Know, for Search" }
Instal Plugin Elasticsearch Ingest

Plugin menelan meluas Elasticsearch dengan menyediakan tambahan kemampuan menelan simpul.

Untuk menginstal plugin, jalankan perintah di bawah ini;

/usr/share/elasticsearch/bin/elasticsearch-plugin install ingest-attachment
Tune Elasticsearch

Tingkatkan jumlah peta memori virtual;

echo vm.max_map_count=262144 >> /etc/sysctl.conf
sysctl -p

Tingkatkan ukuran maksimum badan permintaan HTTP (defaultnya adalah 100MB).

echo "http.max_content_length: 400mb" >> /etc/elasticsearch/elasticsearch.yml

Mulai ulang Elasticsearch

systemctl restart elasticsearch
Konfigurasikan Zammad untuk menggunakan Elasticsearch

Jalankan perintah di bawah ini untuk menentukan URL Zammad Elasticsearch, membangun kembali indeks, menyesuaikan jarak nama indeks serta aturan pengindeksan lampiran file.

zammad run rails r "Setting.set('es_url', 'http://localhost:9200')" 
zammad run rake searchindex:rebuild
zammad run rails r "Setting.set('es_attachment_ignore', [ '.png', '.jpg', '.jpeg', '.mpeg', '.mpg', '.mov', '.bin', '.exe', '.box', '.mbox' ] )"
zammad run rails r "Setting.set('es_attachment_max_size_in_mb', 50)"

Instal Postfix untuk Notifikasi Email Zammad

Agar Zammad mengirimkan notifikasi email, Anda dapat menginstal postfix;

apt install postfix

Mengakses Interface Zammad

Untuk mengakses interface web Zammad, Anda perlu memperbarui beberapa konfigurasi server web Nginx.

Sebenarnya, satu-satunya perubahan yang dapat kami lakukan adalah membuat situs tersedia dan dapat diakses dari luar dengan mengubah nilai nama_server menjadi nama domain yang sepenuhnya memenuhi syarat yang dapat diselesaikan;

vim /etc/nginx/sites-available/zammad.conf
server { listen 80; # replace 'localhost' with your fqdn if you want to use zammad from remote #server_name localhost;  server_name helpdesk.kifarunix-demo.com;...

Simpan file dan keluar.

Periksa sintaks Nginx dan mulai ulang jika semuanya baik-baik saja;

nginx -t
systemctl restart nginx

Anda sekarang dapat mengakses interface Web Zammad dengan menavigasi ke URL, http://<server-domain>.

Anda akan disambut oleh halaman setup Zammad;

Klik Setup new system untuk melanjutkan.

Siapkan akun Administrator Zammad.

Selanjutnya, tetapkan nama organisasi, logo, dan url zammad Anda;

Konfigurasikan pengaturan pemberitahuan Email. Kami menggunakan relai Gmail dalam kasus kami.Ensure you have already installed Postfix.

Juga, izinkan akses aplikasi yang kurang aman sebelum mengklikContinue.

Anda dapat mengatur saluran komunikasi Zammad. KlikEmail untuk mengatur saluran komunikasi email.

Setelah Anda selesai dengan pengaturan, Anda harus mendarat di dasbor.

Dan itu saja tentang cara menginstal Sistem Tiket Zammad di Ubuntu 20.04.

Anda dapat melanjutkan dengan pengaturan untuk sepenuhnya menggunakan Zammad.

Referensi

Dokumentasi Zammad

Tutorial lainnya

Instal Request Tracker (RT) dengan MariaDB di CentOS 8

Konfigurasikan Pelacak Permintaan (RT) untuk mengirim Email menggunakan MSMTP melalui Relai Office 365