Sådan installeres Zammad 2.0 på Ubuntu 16.04 LTS

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 osv.

Forudsætninger

• En frisk Vultr Ubuntu 16.04 LTS 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 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 udgivelse af OpenJDK 8.

sudo apt install -y openjdk-8-jdk

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

java -version

Outputtet vil se sådan ud.

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)

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 søgefunktionen. På Ubuntu 16.04 kan du installere den seneste stabile udgivelse af Elasticsearch 5 ved hjælp af den officielle Elasticsearch DEB-repo som nedenfor.

Først skal du downloade og installere den offentlige signeringsnøgle til Elasticsearch 5.

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

Installer derefter apt-transport-httpspakken.

sudo apt install -y apt-transport-https

Gem lagerdefinitionen til /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

Installer derefter Elasticsearch 5.x ved hjælp af APT.

sudo apt update -y
sudo apt install -y elasticsearch

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

sudo systemctl daemon-reload
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-attachmentspluginnet som følger.

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.service

Trin 4: Installer Zammad 2.0

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

Først og fremmest skal du sørge for, at serverinstansen bruger en UTF-8lokalitet, ellers kan PostgreSQL ikke installeres.

locale

Hvis du finder andre lokalitetsindstillinger end en_US.UTF-8, skal du skifte til denne lokalitet som følger.

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

Når du har sikret dig, at lokaliteten er korrekt, skal du downloade den officielle 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

Installer Zammad og alle de nødvendige afhængigheder ved hjælp af APT.

sudo apt update -y
sudo apt 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

Dens 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/sites-available/zammad.conf

Find linjen.

 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 apt install -y policycoreutils
sestatus

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

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

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

Du skal også ændre UFW firewall regler som følger.

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

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

Peg din yndlingswebbrowser til http://helpdesk.example.com, og så bliver du 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.