Hur man installerar Zammad 2.0 på Ubuntu 16.04 LTS

Zammad är ett open source helpdesk/biljettsystem designat för kundsupportteam. Med Zammad kan kundtjänstrepresentanter enkelt hantera kundfrågor och klagomål från olika kanaler, inklusive webb, formulär, e-post, chatt, Twitter, Facebook, etc.

Förutsättningar

• En fräsch Vultr Ubuntu 16.04 LTS x64-serverinstans med minst 4 GB minne. Säg att dess IP-adress är 203.0.113.1och dess värdnamn är helpdesk.
• En domän helpdesk.example.comkonfigurerad att peka på serverinstansen som nämns ovan. Du kan lära dig mer information om detta i en annan Vultr-handledning .
• En sudo-användare .
• Serverinstansen har uppdaterats till den senaste stabila statusen .
• I en produktionsmiljö rekommenderas det att konfigurera en växlingsfil för att optimera prestandan.

Steg 1: Konfigurera FQDN (fullt kvalificerat domännamn)

Som krävs av Zammad måste du ställa in FQDN på din serverinstans på rätt sätt innan du kan fjärråtkomst till Zammad-webbplatsen.

Använd vitextredigeraren för att öppna /etc/hostsfilen.

sudo vi /etc/hosts

Infoga följande rad före eventuella befintliga rader.

203.0.113.1 helpdesk.example.com helpdesk

Spara och avsluta.

:wq!

Använd hostname -fkommandot för att bekräfta resultatet, som kommer att se ut så här.

helpdesk.example.com

Steg 2: Installera OpenJDK 8-paket

Som krävs av Zammad måste du installera Java på din serverinstans innan du kan installera och köra Zammad.

Installera den senaste stabila versionen av OpenJDK 8.

sudo apt install -y openjdk-8-jdk

När OpenJDK 8 är installerat kan du verifiera resultatet.

java -version

Utgången kommer att se ut så här.

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)

Slutligen, ställ in JAVA_HOMEmiljövariabeln.

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

Steg 3: Installera Elasticsearch 5 och plugin-appen mapper-attachments

Zammad använder Elasticsearch för att tillhandahålla sökfunktionen. På Ubuntu 16.04 kan du installera den senaste stabila versionen av Elasticsearch 5 med den officiella Elasticsearch DEB-repo enligt nedan.

Ladda först ner och installera Elasticsearch 5 offentliga signeringsnyckel.

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

Installera sedan apt-transport-httpspaketet.

sudo apt install -y apt-transport-https

Spara förvarsdefinitionen till /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

Installera sedan Elasticsearch 5.x med APT.

sudo apt update -y
sudo apt install -y elasticsearch

Slutligen, starta Elasticsearch-tjänsten och få den att starta automatiskt vid uppstart.

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

Dessutom, för att tillåta Elasticsearch att indexera filbilagor, måste du installera Elasticsearch-pluginet mapper-attachmentsenligt följande.

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

När du blir ombedd att godkänna ytterligare behörigheter, skriv " Y" och tryck sedan på " Enter" för att avsluta installationen.

Starta om Elasticsearch-tjänsten för att ladda det nya plugin-programmet.

sudo systemctl restart elasticsearch.service

Steg 4: Installera Zammad 2.0

För att underlätta installationsprocessen kan du använda den officiella Zammad DEB-repo för att installera Zammad tillsammans med olika beroenden, inklusive Nginx, PostgreSQL och mer, allt på samma gång.

Först och främst, se till att serverinstansen använder en UTF-8lokalitet, annars kan PostgreSQL inte installeras.

locale

Om du hittar andra språkinställningar än en_US.UTF-8, måste du byta till den språkinställningen enligt följande.

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

Efter att ha säkerställt att lokalen är korrekt, ladda ner den officiella 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

Installera Zammad och alla nödvändiga beroenden med APT.

sudo apt update -y
sudo apt install -y zammad

När Zammad har installerats framgångsrikt kommer Zammad-tjänsten att starta automatiskt. Du kan använda följande kommando för att bekräfta Zammad-tjänstens status.

sudo systemctl status zammad.service

Dess status kommer att vara active (running).

Använd sedan följande kommandon för att få Zammad att fungera med Elasticsearch och bygga om indexet.

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

Lägg till extra Elasticsearch-indexnamnutrymme (valfritt).

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

Ignorera vanliga binära filtyper (valfritt).

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

Ställ in max storlek på redskapet (valfritt).

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

För att tillåta användare att fjärråtkomst till Zammad måste du ändra Zammad Nginx-konfigurationsfilen.

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

Hitta linjen.

 server_name localhost;

Ersätt localhostmed FQDN för din serverinstans.

server_name helpdesk.example.com;

Spara och avsluta.

:wq!

Slutligen, starta om Nginx-tjänsten för att tillämpa dina ändringar.

sudo systemctl restart nginx.service

Steg 5: Ställ in SELinux och brandväggsregler

Använd följande kommandon för att bestämma statusen för SELinux på din serverinstans.

sudo apt install -y policycoreutils
sestatus

Om SELinux är aktiverat i enforcingläget på din maskin, måste du ändra en SELinux-regel enligt följande.

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

Om SELinux är disabledeller aktiverat i permissiveläget, ignorera ovanstående ändringar och gå vidare.

Du måste också ändra UFW-brandväggsreglerna enligt följande.

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

Steg 6: Konfigurera det nya Zammad-systemet från webbgränssnittet

Peka på din favoritwebbläsare http://helpdesk.example.comoch sedan kommer du in på Zammad getting startedsidan.

Klicka på Setup new systemknappen för att gå vidare.

I Administrator Accountfönstret anger du administratörens förnamn, efternamn, e-postadress och lösenord (två gånger) och klickar sedan på Createknappen.

I Organizationfönstret anger du organisationens namn och system-URL http://helpdesk.example.com, ladda upp din logotyp (om någon) och klicka sedan på Nextknappen.

Email NotificationVälj en lämplig metod för att skicka e-post i fönstret och klicka sedan på Continueknappen.

Connect ChannelsKlicka på Skipknappen i fönstret för att slutföra den första installationen. Alla kanaler kan anpassas senare.

Det är allt för att sätta upp ett fungerande Zammad-biljettsystem. Utforska gärna Zammad-gränssnittet och bjud in kundtjänstrepresentanter. Tack för att du läser.