Hoe Zammad 2.0 op Ubuntu 16.04 LTS te installeren

• Vereisten
• Stap 1: Stel de FQDN in (volledig gekwalificeerde domeinnaam)
• Stap 2: Installeer OpenJDK 8-pakketten
• Stap 3: Installeer Elasticsearch 5 en de mapper-attachments-plug-in
• Stap 4: Installeer Zammad 2.0
• Stap 5: Stel SELinux en firewall regels in
• Stap 6: Stel het nieuwe Zammad-systeem in via de webinterface

Zammad is een open source helpdesk / ticketingsysteem dat is ontworpen voor klantenserviceteams. Met Zammad kunnen vertegenwoordigers van de klantenservice gemakkelijk vragen van klanten en klachten van verschillende kanalen behandelen, waaronder web, formulier, e-mail, chat, Twitter, Facebook, enz.

Vereisten

• Een nieuwe Vultr Ubuntu 16.04 LTS x64-serverinstantie met minimaal 4 GB geheugen. Stel dat het IP-adres is 203.0.113.1en de hostnaam helpdesk.
• Een domein dat is helpdesk.example.comgeconfigureerd om te verwijzen naar de hierboven genoemde serverinstantie. Je kunt hier meer over leren in een andere Vultr-zelfstudie .
• Een sudo-gebruiker .
• De serverinstantie is bijgewerkt naar de laatste stabiele status .
• In een productieomgeving wordt aanbevolen om een wisselbestand in te stellen om de prestaties te optimaliseren.

Stap 1: Stel de FQDN in (volledig gekwalificeerde domeinnaam)

Zoals vereist door Zammad, moet u de FQDN op uw serverinstantie correct instellen voordat u op afstand toegang kunt krijgen tot de Zammad-site.

Gebruik de viteksteditor om het /etc/hostsbestand te openen .

sudo vi /etc/hosts

Voeg de volgende regel in vóór eventuele bestaande regels.

203.0.113.1 helpdesk.example.com helpdesk

Opslaan en afsluiten.

:wq!

Gebruik de hostname -fopdracht om het resultaat te bevestigen, dat er als volgt uitziet.

helpdesk.example.com

Stap 2: Installeer OpenJDK 8-pakketten

Zoals vereist door Zammad, moet u Java op uw serverinstantie installeren voordat u Zammad kunt installeren en uitvoeren.

Installeer de nieuwste stabiele release van OpenJDK 8.

sudo apt install -y openjdk-8-jdk

Als OpenJDK 8 is geïnstalleerd, kunt u het resultaat verifiëren.

java -version

De uitvoer ziet er als volgt uit.

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)

Stel tot slot de JAVA_HOMEomgevingsvariabele in.

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

Stap 3: Installeer Elasticsearch 5 en de mapper-attachments-plug-in

Zammad gebruikt Elasticsearch om de zoekfunctie te bieden. Op Ubuntu 16.04 kunt u de nieuwste stabiele release van Elasticsearch 5 installeren met behulp van de officiële Elasticsearch DEB-repo zoals hieronder.

Download en installeer eerst de Elasticsearch 5 openbare ondertekeningssleutel.

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

Installeer vervolgens het apt-transport-httpspakket.

sudo apt install -y apt-transport-https

Sla de repository-definitie op /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

Installeer vervolgens Elasticsearch 5.x met APT.

sudo apt update -y
sudo apt install -y elasticsearch

Start ten slotte de Elasticsearch-service en laat deze automatisch starten tijdens het opstarten.

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

Om Elasticsearch toe te staan ​​bestandsbijlagen te indexeren, moet u bovendien de Elasticsearch- mapper-attachmentsplug-in als volgt installeren .

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

Wanneer u wordt gevraagd om aanvullende machtigingen goed te keuren, typt u " Y" en drukt u vervolgens op " Enter" om de installatie te voltooien.

Start de Elasticsearch-service opnieuw om de nieuwe plug-in te laden.

sudo systemctl restart elasticsearch.service

Stap 4: Installeer Zammad 2.0

Om het installatieproces te vergemakkelijken, kun je de officiële Zammad DEB-repo gebruiken om Zammad samen met verschillende afhankelijkheden, waaronder Nginx, PostgreSQL en meer, allemaal tegelijk te installeren.

Zorg er allereerst voor dat de serverinstantie een UTF-8landinstelling gebruikt, anders kan PostgreSQL niet worden geïnstalleerd.

locale

Als u andere landinstellingen vindt dan en_US.UTF-8, moet u als volgt naar die landinstelling overschakelen.

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

Download de officiële Zammad DEB-repo nadat je ervoor hebt gezorgd dat de locatie correct is.

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

Installeer Zammad en alle vereiste afhankelijkheden met APT.

sudo apt update -y
sudo apt install -y zammad

Als Zammad met succes is geïnstalleerd, wordt de Zammad-service automatisch gestart. U kunt de volgende opdracht gebruiken om de status van de Zammad-service te bevestigen.

sudo systemctl status zammad.service

De status zal zijn active (running).

Gebruik vervolgens de volgende opdrachten om Zammad te laten werken met Elasticsearch en de index opnieuw op te bouwen.

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

Voeg extra Elasticsearch-indexnaamruimte toe (optioneel).

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

Negeer veelvoorkomende binaire bestandstypen (optioneel).

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

Stel de maximale grootte van de bijlage in (optioneel).

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

Om gebruikers op afstand toegang te geven tot Zammad, moet je het Zammad Nginx-configuratiebestand wijzigen.

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

Zoek de lijn.

 server_name localhost;

Vervang localhostdoor de FQDN van uw serverinstantie.

server_name helpdesk.example.com;

Opslaan en afsluiten.

:wq!

Start ten slotte de Nginx-service opnieuw op om uw wijzigingen toe te passen.

sudo systemctl restart nginx.service

Stap 5: Stel SELinux en firewall regels in

Gebruik de volgende opdrachten om de status van SELinux op uw serverinstantie te bepalen.

sudo apt install -y policycoreutils
sestatus

Als SELinux is ingeschakeld in de enforcingmodus op uw machine, moet u een SELinux-regel als volgt wijzigen.

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

Als SELinux disabledin de permissivemodus is of is ingeschakeld , negeer dan bovenstaande wijzigingen en ga verder.

U moet ook de UFW-firewallregels als volgt wijzigen.

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

Stap 6: Stel het nieuwe Zammad-systeem in via de webinterface

Wijs uw favoriete webbrowser aan http://helpdesk.example.comen u wordt naar de Zammad getting startedpagina geleid .

Klik op de Setup new systemknop om verder te gaan.

Voer in het Administrator Accountvenster de voornaam, achternaam, e-mailadres en wachtwoord van de beheerder (tweemaal) in en klik vervolgens op de Createknop.

Voer in het Organizationvenster de organisatienaam en de systeem-URL in http://helpdesk.example.com, upload uw logo (indien aanwezig) en klik vervolgens op de Nextknop.

Email NotificationKies in het venster een juiste verzendmethode voor e-mail en klik vervolgens op de Continueknop.

Klik in het Connect Channelsvenster op de Skipknop om de eerste installatie te voltooien. Alle kanalen kunnen later worden aangepast.

Dat is alles voor het opzetten van een operationeel ticketsysteem van Zammad. Voel je vrij om de Zammad-interface te verkennen en vertegenwoordigers van de klantenservice uit te nodigen. Bedankt voor het lezen.