Sådan installeres Zammad 2.0 på CentOS 7

Zammad er et open source helpdesk/billetsystem designet til kundesupportteams. Med Zammad kan kundeservicemedarbejdere nemt håndtere kundeforespørgsler og -klager fra forskellige kanaler, herunder web, formular, e-mail, chat, Twitter, Facebook og så videre.

Forudsætninger

• En frisk Vultr CentOS 7 x64-serverinstans med mindst 4 GB hukommelse. Sig, at dens IP-adresse er 203.0.113.1, og dens værtsnavn er helpdesk.
• Et domæne helpdesk.example.comkonfigureret til at pege på serverforekomsten nævnt ovenfor. Du kan lære flere detaljer om dette i en anden Vultr-tutorial .
• En sudo-bruger .
• Serverforekomsten er blevet opdateret til den seneste stabile status .
• I et produktionsmiljø anbefales det at opsætte en swap-fil for at optimere ydeevnen.

Trin 1: Konfigurer FQDN (fuldt kvalificeret domænenavn)

Som krævet af Zammad, skal du konfigurere FQDN korrekt på din serverinstans, før du kan få fjernadgang til Zammad-webstedet.

Brug viteksteditoren til at åbne /etc/hostsfilen.

sudo vi /etc/hosts

Indsæt følgende linje før eventuelle eksisterende linjer.

203.0.113.1 helpdesk.example.com helpdesk

Gem og afslut.

:wq!

Brug hostname -fkommandoen til at bekræfte resultatet, som vil se sådan ud.

helpdesk.example.com

Trin 2: Installer OpenJDK 1.8-pakker

Som krævet af Zammad, skal du installere Java på din serverinstans, før du kan installere og køre Zammad.

Installer den seneste stabile udgave af OpenJDK 1.8.

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

Når OpenJDK 1.8 er installeret, kan du verificere resultatet.

java -version

Outputtet vil se sådan ud.

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)

Til sidst skal du opsætte JAVA_HOMEmiljøvariablen.

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

Trin 3: Installer Elasticsearch 5 og mapper-attachments plugin

Zammad bruger Elasticsearch til at levere sin søgefunktion. På CentOS 7 kan du installere den seneste stabile udgivelse af Elasticsearch 5 ved hjælp af den officielle Elasticsearch YUM-repo som nedenfor.

Installer først den offentlige signeringsnøgle til Elasticsearch 5.

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

Konfigurer derefter Elasticsearch YUM-repoen.

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

Installer derefter Elasticsearch ved hjælp af YUM.

sudo yum install -y elasticsearch

Til sidst skal du starte Elasticsearch-tjenesten og få den til automatisk at starte ved opstart.

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

Derudover, for at tillade Elasticsearch at indeksere vedhæftede filer, skal du installere Elasticsearch- mapper-attachmentsplugin'et.

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

Når du bliver bedt om at godkende yderligere tilladelser, skriv " Y" og tryk derefter på " Enter" for at afslutte installationen.

Genstart Elasticsearch-tjenesten for at indlæse det nye plugin.

sudo systemctl restart elasticsearch

Trin 4: Installer Zammad 2.0

For at lette installationsprocessen kan du bruge den officielle Zammad YUM-repo til at installere Zammad sammen med forskellige afhængigheder, inklusive Nginx, PostgreSQL og mere på samme tid.

Download den officielle Zammad YUM-repo.

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

Installer Zammad og alle de nødvendige afhængigheder.

sudo yum install -y zammad

Når Zammad er installeret, starter Zammad-tjenesten automatisk. Du kan bruge følgende kommando til at bekræfte Zammad-tjenestens status.

sudo systemctl status zammad.service

Zammads status vil være active (running).

Brug derefter følgende kommandoer til at få Zammad til at arbejde med Elasticsearch og genopbygge indekset.

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

Tilføj ekstra Elasticsearch-indeksnavneplads (valgfrit).

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

Ignorer almindelige binære filtyper (valgfrit).

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

Indstil den maksimale vedhæftede størrelse (valgfrit).

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

For at tillade brugere at få fjernadgang til Zammad, skal du ændre Zammad Nginx-konfigurationsfilen.

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

Find denne linje.

 server_name localhost;

Erstat localhostmed FQDN for din serverforekomst.

server_name helpdesk.example.com;

Gem og afslut.

:wq!

Til sidst skal du genstarte Nginx-tjenesten for at anvende dine ændringer.

sudo systemctl restart nginx.service

Trin 5: Konfigurer SELinux og firewall-regler

Brug følgende kommandoer til at bestemme status for SELinux på din serverinstans.

sudo yum install -y policycoreutils
sestatus

Hvis SELinux er aktiveret i enforcingtilstanden på din maskine, skal du ændre en SELinux-regel som følger.

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

Hvis SELinux er deaktiveret eller aktiveret i permissivetilstanden, ignorer ovenstående ændringer og gå videre.

Du skal også ændre firewall-reglerne som følger.

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

Trin 6: Konfigurer det nye Zammad-system fra webgrænsefladen

Peg din yndlingswebbrowser til http://helpdesk.example.com, og du vil blive bragt ind på Zammad getting startedsiden.

Klik på Setup new systemknappen for at komme videre.

Administrator AccountIndtast administratorens fornavn, efternavn, e-mail og adgangskode (to gange) i vinduet, og klik derefter på Createknappen.

OrganizationIndtast organisationens navn og system-URL i vinduet, http://helpdesk.example.comupload dit logo (hvis nogen), og klik derefter på Nextknappen.

Email NotificationVælg en korrekt e-mail-afsendelsesmetode i vinduet, og klik derefter på Continueknappen.

Connect ChannelsKlik på Skipknappen i vinduet for at afslutte den indledende opsætning. Alle kanaler kan tilpasses senere.

Det er alt for at opsætte et operationelt Zammad-billetsystem. Du er velkommen til at udforske Zammad-grænsefladen og invitere kundeservicerepræsentanter. Tak fordi du læste med.