Forutsetninger
Trinn 1: Konfigurer FQDN (fullt kvalifisert domenenavn)
Trinn 2: Installer OpenJDK 1.8-pakker
Trinn 3: Installer Elasticsearch 5 og mapper-attachments-plugin
Trinn 4: Installer Zammad 2.0
Trinn 5: Konfigurer SELinux og brannmurregler
Trinn 6: Konfigurer det nye Zammad-systemet fra webgrensesnittet
Zammad er et åpen kildekode-helpdesk/billettsystem designet for kundestøtteteam. Med Zammad kan kundeservicerepresentanter enkelt håndtere kundeforespørsler og klager fra ulike kanaler, inkludert web, skjema, e-post, chat, Twitter, Facebook og så videre.
Forutsetninger
- En fersk Vultr CentOS 7 x64 serverforekomst med minst 4 GB minne. Si at IP-adressen er
203.0.113.1, og vertsnavnet er helpdesk.
- Et domene
helpdesk.example.comkonfigurert til å peke til serverforekomsten nevnt ovenfor. Du kan lære mer om dette i en annen Vultr-opplæring .
- En sudo-bruker .
- Serverforekomsten har blitt oppdatert til siste stabile status .
- I et produksjonsmiljø anbefales det å sette opp en byttefil for å optimalisere ytelsen.
Trinn 1: Konfigurer FQDN (fullt kvalifisert domenenavn)
Som kreves av Zammad, må du konfigurere FQDN på serverforekomsten din før du kan eksternt få tilgang til Zammad-siden.
Bruk vitekstredigering for å åpne /etc/hostsfilen.
sudo vi /etc/hosts
Sett inn følgende linje før eventuelle eksisterende linjer.
203.0.113.1 helpdesk.example.com helpdesk
Lagre og avslutt.
:wq!
Bruk hostname -fkommandoen for å bekrefte resultatet, som vil se slik ut.
helpdesk.example.com
Trinn 2: Installer OpenJDK 1.8-pakker
Som kreves av Zammad, må du installere Java på serverforekomsten din før du kan installere og kjøre Zammad.
Installer den siste stabile utgaven av OpenJDK 1.8.
sudo yum install -y java-1.8.0-openjdk-devel
Etter å ha installert OpenJDK 1.8, kan du bekrefte resultatet.
java -version
Utgangen vil se slik ut.
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 slutt setter du opp JAVA_HOMEmiljøvariabelen.
echo "JAVA_HOME=$(readlink -f /usr/bin/java | sed "s:bin/java::")" | sudo tee -a /etc/profile
source /etc/profile
Trinn 3: Installer Elasticsearch 5 og mapper-attachments-plugin
Zammad bruker Elasticsearch for å tilby søkefunksjonen. På CentOS 7 kan du installere den siste stabile versjonen av Elasticsearch 5 ved å bruke den offisielle Elasticsearch YUM-repoen som nedenfor.
Installer først den offentlige signeringsnøkkelen Elasticsearch 5.
sudo rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch
Deretter konfigurerer du 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
Deretter installerer du Elasticsearch med YUM.
sudo yum install -y elasticsearch
Til slutt, start Elasticsearch-tjenesten og få den til å starte automatisk ved oppstartstid.
sudo systemctl start elasticsearch.service
sudo systemctl enable elasticsearch.service
I tillegg, for å tillate Elasticsearch å indeksere filvedlegg, må du installere Elasticsearch- mapper-attachmentsplugin.
sudo /usr/share/elasticsearch/bin/elasticsearch-plugin install mapper-attachments
Når du blir bedt om å godkjenne ytterligere tillatelser, skriv " Y" og trykk deretter på " Enter" for å fullføre installasjonen.
Start Elasticsearch-tjenesten på nytt for å laste den nye plugin-en.
sudo systemctl restart elasticsearch
Trinn 4: Installer Zammad 2.0
For å lette installasjonsprosessen kan du bruke den offisielle Zammad YUM-repoen til å installere Zammad sammen med ulike avhengigheter, inkludert Nginx, PostgreSQL og mer, samtidig.
Last ned den offisielle Zammad YUM-repoen.
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 nødvendige avhengigheter.
sudo yum install -y zammad
Når Zammad er installert, starter Zammad-tjenesten automatisk. Du kan bruke følgende kommando for å bekrefte Zammad-tjenestens status.
sudo systemctl status zammad.service
Zammads status vil være active (running).
Deretter bruker du følgende kommandoer for å få Zammad til å fungere med Elasticsearch og gjenoppbygge indeksen.
sudo zammad run rails r "Setting.set('es_url', 'http://localhost:9200')"
sudo zammad run rake searchindex:rebuild
Legg til ekstra Elasticsearch-indeksnavnrom (valgfritt).
sudo zammad run rails r "Setting.set('es_index', Socket.gethostname + '_zammad')"
Ignorer vanlige binære filtyper (valgfritt).
sudo zammad run rails r "Setting.set('es_attachment_ignore', [ '.png', '.jpg', '.jpeg', '.mpeg', '.mpg', '.mov', '.bin', '.exe', '.box', '.mbox' ] )"
Still inn maks størrelse på vedlegg (valgfritt).
sudo zammad run rails r "Setting.set('es_attachment_max_size_in_mb', 50)"
For å gi brukere ekstern tilgang til Zammad, må du endre Zammad Nginx-konfigurasjonsfilen.
sudo vi /etc/nginx/conf.d/zammad.conf
Finn denne linjen.
server_name localhost;
Erstatt localhostmed FQDN for serverforekomsten din.
server_name helpdesk.example.com;
Lagre og avslutt.
:wq!
Til slutt, start Nginx-tjenesten på nytt for å bruke endringene dine.
sudo systemctl restart nginx.service
Trinn 5: Konfigurer SELinux og brannmurregler
Bruk følgende kommandoer for å bestemme statusen til SELinux på serverforekomsten din.
sudo yum install -y policycoreutils
sestatus
Hvis SELinux er aktivert i enforcingmodusen på maskinen din, må du endre 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 deaktivert eller aktivert i permissivemodusen, ignorer modifikasjonene ovenfor og gå videre.
Du må også endre brannmurreglene 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
Trinn 6: Konfigurer det nye Zammad-systemet fra webgrensesnittet
Pek på favorittnettleseren din http://helpdesk.example.com, og du vil bli tatt inn på Zammad getting startedsiden.
Klikk på Setup new systemknappen for å gå videre.
I Administrator Accountvinduet skriver du inn administratorens fornavn, etternavn, e-post og passord (to ganger), og klikk deretter på Createknappen.
Skriv inn Organizationorganisasjonsnavnet og system-URLen i vinduet, http://helpdesk.example.comlast opp logoen din (hvis noen), og klikk deretter på Nextknappen.
I Email Notificationvinduet velger du en riktig metode for e-postsending, og klikker deretter på Continueknappen.
I Connect Channelsvinduet klikker du på Skipknappen for å fullføre det første oppsettet. Alle kanaler kan tilpasses senere.
Det er alt for å sette opp et operativt Zammad-billettsystem. Utforsk gjerne Zammad-grensesnittet og inviter kundeservicerepresentanter. Takk for at du leste.