Com instal·lar Zammad 2.0 a Ubuntu 16.04 LTS

Zammad és un sistema d'assistència/tickets de codi obert dissenyat per als equips d'atenció al client. Amb Zammad, els representants d'atenció al client poden tractar fàcilment les consultes i queixes dels clients des de diversos canals, com ara web, formularis, correu electrònic, xat, Twitter, Facebook, etc.

Requisits previs

• Una nova instància del servidor Vultr Ubuntu 16.04 LTS x64 amb almenys 4 GB de memòria. Diguem que la seva adreça IP és 203.0.113.1, i el seu nom d'amfitrió és helpdesk.
• Un domini helpdesk.example.comconfigurat per apuntar a la instància del servidor esmentada anteriorment. Podeu obtenir més detalls sobre això en un altre tutorial de Vultr .
• Un usuari de sudo .
• La instància del servidor s'ha actualitzat a l'estat estable més recent .
• En un entorn de producció, es recomana configurar un fitxer d'intercanvi per tal d'optimitzar el rendiment.

Pas 1: configureu el FQDN (nom de domini complet)

Tal com requereix Zammad, heu de configurar correctament el FQDN a la instància del vostre servidor abans de poder accedir de manera remota al lloc de Zammad.

Utilitzeu l' vieditor de text per obrir el /etc/hostsfitxer.

sudo vi /etc/hosts

Inseriu la línia següent abans de qualsevol línia existent.

203.0.113.1 helpdesk.example.com helpdesk

Desa i surt.

:wq!

Utilitzeu l' hostname -fordre per confirmar el resultat, que es veurà així.

helpdesk.example.com

Pas 2: instal·leu els paquets OpenJDK 8

Tal com requereix Zammad, heu d'instal·lar Java a la vostra instància de servidor abans de poder instal·lar i executar Zammad.

Instal·leu la darrera versió estable d'OpenJDK 8.

sudo apt install -y openjdk-8-jdk

Tenint instal·lat OpenJDK 8, podeu verificar el resultat.

java -version

La sortida es veurà així.

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)

Finalment, configureu la JAVA_HOMEvariable d'entorn.

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

Pas 3: instal·leu Elasticsearch 5 i el connector de mapper-attachments

Zammad utilitza Elasticsearch per proporcionar la funció de cerca. A Ubuntu 16.04, podeu instal·lar la darrera versió estable d'Elasticsearch 5 mitjançant el repo oficial d'Elasticsearch DEB com a continuació.

Primer, descarregueu i instal·leu la clau de signatura pública d'Elasticsearch 5.

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

A continuació, instal·leu el apt-transport-httpspaquet.

sudo apt install -y apt-transport-https

Deseu la definició del repositori a /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

A continuació, instal·leu Elasticsearch 5.x mitjançant APT.

sudo apt update -y
sudo apt install -y elasticsearch

Finalment, inicieu el servei Elasticsearch i feu que s'iniciï automàticament en el moment d'arrencar.

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

A més, per permetre que Elasticsearch indexi els fitxers adjunts, cal que instal·leu el mapper-attachmentsconnector Elasticsearch de la manera següent.

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

Quan se us demani que aproveu permisos addicionals, escriviu " Y" i premeu " Enter" per finalitzar la instal·lació.

Reinicieu el servei Elasticsearch per carregar el connector nou.

sudo systemctl restart elasticsearch.service

Pas 4: instal·leu Zammad 2.0

Per tal de facilitar el procés d'instal·lació, podeu utilitzar el repo oficial de Zammad DEB per instal·lar Zammad juntament amb diverses dependències, com ara Nginx, PostgreSQL i més, tot alhora.

En primer lloc, assegureu-vos que la instància del servidor està utilitzant una UTF-8configuració regional, en cas contrari no es pot instal·lar PostgreSQL.

locale

Si trobeu qualsevol configuració regional que no sigui en_US.UTF-8, haureu de canviar a aquesta configuració regional de la següent manera.

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

Després d'assegurar-vos que la configuració regional és correcta, descarregueu el repo oficial de Zammad DEB.

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

Instal·leu Zammad i totes les dependències necessàries mitjançant APT.

sudo apt update -y
sudo apt install -y zammad

Un cop instal·lat Zammad correctament, el servei Zammad s'iniciarà automàticament. Podeu utilitzar l'ordre següent per confirmar l'estat del servei Zammad.

sudo systemctl status zammad.service

El seu estat serà active (running).

A continuació, utilitzeu les ordres següents per fer que Zammad funcioni amb Elasticsearch i reconstruïu l'índex.

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

Afegiu un espai de nom d'índex Elasticsearch addicional (opcional).

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

Ignoreu els tipus de fitxers binaris habituals (opcional).

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

Estableix la mida màxima del fitxer adjunt (opcional).

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

Per permetre als usuaris accedir a Zammad de forma remota, heu de modificar el fitxer de configuració de Zammad Nginx.

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

Troba la línia.

 server_name localhost;

Substituïu localhost-lo pel FQDN de la vostra instància de servidor.

server_name helpdesk.example.com;

Desa i surt.

:wq!

Finalment, reinicieu el servei Nginx per aplicar les vostres modificacions.

sudo systemctl restart nginx.service

Pas 5: configureu SELinux i les regles del tallafoc

Utilitzeu les ordres següents per determinar l'estat de SELinux a la vostra instància de servidor.

sudo apt install -y policycoreutils
sestatus

Si SELinux està habilitat en el enforcingmode de la vostra màquina, haureu de modificar una regla de SELinux de la manera següent.

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

Si SELinux està disabledo està habilitat en el permissivemode, ignoreu les modificacions anteriors i continueu.

També heu de modificar les regles del tallafoc UFW de la manera següent.

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

Pas 6: configureu el nou sistema Zammad des de la interfície web

Apunteu el vostre navegador web preferit a http://helpdesk.example.com, i després se us portarà a la Zammad getting startedpàgina.

Feu clic al Setup new systembotó per seguir endavant.

A la Administrator Accountfinestra, introduïu el nom, el cognom, el correu electrònic i la contrasenya de l'administrador (dues vegades) i feu clic al Createbotó.

A la Organizationfinestra, introduïu el nom de l'organització i l'URL del sistema http://helpdesk.example.com, carregueu el vostre logotip (si n'hi ha) i feu clic al Nextbotó.

A la Email Notificationfinestra, trieu un mètode d'enviament de correu electrònic adequat i, a continuació, feu clic al Continuebotó.

A la Connect Channelsfinestra, feu clic al Skipbotó per finalitzar la configuració inicial. Tots els canals es poden personalitzar més endavant.

Això és tot per configurar un sistema de venda d'entrades Zammad operatiu. No dubteu a explorar la interfície de Zammad i convidar els representants d'atenció al client. Gràcies per llegir.