Com instal·lar el sistema de tiquets Zammad a Ubuntu 20.04 LTS

Zammad és una solució de tiquets gratuïta, de codi obert i amb totes les funcions escrites en Ruby. És un sistema web amb moltes funcions per gestionar la comunicació amb el client a través de diversos canals com ara telèfon, Facebook, Twitter, xat i correus electrònics.

També pots atendre fàcilment les consultes i queixes dels clients. Zammad inclou un ampli conjunt de característiques que inclouen cerca de text complet, desament automàtic, capacitat d'auditoria, compatibilitat amb autenticació externa, compatibilitat amb diversos idiomes i molt més.

Requisits previs

• Un servidor Ubuntu 20.04 LTS, d'un mínim de 2 vCore amb 2 GB de memòria per vCore i, per a l'ús d'Elasticsearch (recomanat), un mínim de 6 GB de memòria (requisits de maquinari oficials).
• Accés al servidor amb root o un usuari amb privilegis per executar sudo.

Instal·lació d'Elasticsearch (dependència opcional però recomanada)

Per a la funcionalitat de cerca hauràs d'instal·lar Elasticsearch. Per defecte, no està disponible al repositori predeterminat d'Ubuntu 20.04 LTS. Per això, hauràs d'afegir el repositori d'Elasticsearch al teu sistema.

Primer, instal·la apt-transport-https i la resta de dependències amb l'ordre següent:

# apt update -y && apt install wget libimlib2 apt-transport-https gnupg -y

A continuació, descarrega i afegeix la clau pública per al repositori d'Elasticsearch:

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

I posteriorment afegeix el repositori d'Elasticsearch:

# echo "deb https://artifacts.elastic.co/packages/7.x/apt stable main" | tee -a /etc/apt/sources.list.d/elastic-7.x.list

A continuació, actualitza els repositoris i instal·la Elasticsearch:

# apt update -y && apt install elasticsearch -y

Un cop s'hagi completat la instal·lació, inicia el servei elasticsearch i activa'n l'inici amb el sistema:

# systemctl start elasticsearch && systemctl enable elasticsearch

Addicionalment, pots comprovar l'estat d'Elasticsearch amb l'ordre següent:

# systemctl status elasticsearch

Hauries de veure el resultat següent (active):

● elasticsearch.service - Elasticsearch
     Loaded: loaded (/lib/systemd/system/elasticsearch.service; enabled; vendor preset: enabled)
     Active: active (running) since Wed 2021-08-04 10:46:17 CEST; 4s ago
       Docs: https://www.elastic.co
   Main PID: 3958 (java)
      Tasks: 61 (limit: 1074)
     Memory: 660.9M
     CGroup: /system.slice/elasticsearch.service
             ├─3958 /usr/share/elasticsearch/jdk/bin/java -Xshare:auto -Des.networkaddress.cache.ttl=60 -Des.networkaddress.cache.negative.ttl=10 -XX:+AlwaysPreTouch -Xss1m -Djava.awt.headle>
             └─4125 /usr/share/elasticsearch/modules/x-pack-ml/platform/linux-x86_64/bin/controller

Aug 04 10:45:38 zammad systemd[1]: Starting Elasticsearch...
Aug 04 10:46:17 zammad systemd[1]: Started Elasticsearch.

A continuació, també has de permetre que Elasticsearch indexi els fitxers adjunts. Pots fer-ho amb l'ordre següent:

# /usr/share/elasticsearch/bin/elasticsearch-plugin install ingest-attachment

Hauràs d'acceptar el missatge d'instal·lació i hauries de veure el resultat següent:

-> Installing ingest-attachment
-> Downloading ingest-attachment from elastic
[=================================================] 100%  
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@     WARNING: plugin requires additional permissions     @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
* java.lang.RuntimePermission accessClassInPackage.sun.java2d.cmm.kcms
* java.lang.RuntimePermission accessDeclaredMembers
* java.lang.RuntimePermission getClassLoader
* java.lang.reflect.ReflectPermission suppressAccessChecks
* java.security.SecurityPermission createAccessControlContext
See http://docs.oracle.com/javase/8/docs/technotes/guides/security/permissions.html
for descriptions of what these permissions allow and the associated risks.

Continue with installation? [y/N]y
-> Installed ingest-attachment
-> Please restart Elasticsearch to activate any plugins installed

Un cop instal·lat, reinicia Elasticsearch per carregar el complement nou:

# systemctl restart elasticsearch

Instal·lació de Zammad

Per defecte, Zammad tampoc no està disponible al repositori d'Ubuntu 20.04 LTS. Per tant, hauràs d'afegir el repositori de Zammad al teu sistema.

Primer, afegeix la clau per al repositori:

# wget -qO- https://dl.packager.io/srv/zammad/zammad/key | apt-key add -

Després afegeix el repositori:

# wget -O /etc/apt/sources.list.d/zammad.list \ 
https://dl.packager.io/srv/zammad/zammad/stable/installer/ubuntu/20.04.repo

Un cop afegit el repositori, actualitza els repositoris i instal·la Zammad:

# apt update -y && apt install zammad -y

Completada la instal·lació, pots verificar l'estat de Zammad amb l'ordre següent:

# systemctl status zammad

Hauries de veure el resultat següent (active):

● zammad.service
     Loaded: loaded (/etc/systemd/system/zammad.service; enabled; vendor preset: enabled)
     Active: active (running) since Wed 2021-08-04 11:07:30 CEST; 39s ago
   Main PID: 5371 (sleep)
      Tasks: 1 (limit: 2281)
     Memory: 176.0K
     CGroup: /system.slice/zammad.service
             └─5371 /bin/sleep infinity

Aug 04 11:07:30 zammad systemd[1]: Started zammad.service.

Connectar Zammad amb Elasticsearch

Únicament si has instal·lat Elasticsearch (recomanat) hauràs de fer que Zammad hi funcioni i reconstruir l'índex. Per fer-ho, pots executar les ordres següents:

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

També pots afegir l'espai de noms d'índex d'Elasticsearch addicional, ignorar els tipus de fitxers binaris comuns i establir la mida màxima dels fitxers adjunts. Executa les ordres següents per fer-ho:

# zammad run rails r "Setting.set('es_index', Socket.gethostname + '_zammad')"
# zammad run rails r "Setting.set('es_attachment_ignore', [ '.png', '.jpg', '.jpeg', '.mpeg', '.mpg', '.mov','.bin', '.exe', '.box', '.mbox' ] )"
# zammad run rails r "Setting.set('es_attachment_max_size_in_mb', 50)"

Configurar Nginx per a Zammad

Per defecte, només es pot accedir a Zammad des de localhost. Per tant, hauràs de configurar Nginx per accedir a Zammad des d'una ubicació remota. Per fer-ho, pots editar el fitxer d'amfitrió virtual de Zammad:

# nano /etc/nginx/sites-available/zammad.conf

Hauràs de substituir el localhost de la línia server_name pel FQDN o l'adreça IP del teu servidor:

server_name FQDN_or_your-server-ip;

Desa els canvis, tanca l'editor i verifica la modificació feta:

# nginx -t

Si la configuració és correcta, torna a carregar el servei Nginx per aplicar els canvis fets a la configuració:

# systemctl reload nginx

Si has utilitzat un FQDN pots obtenir un certificat amb Let's Encrypt ràpidament amb Certbot. Pots instal·lar la dependència de NGINX per a Certbot directament:

# apt install python3-certbot-nginx

Després podràs obtenir el certificat per al registre executant:

# certbot --nginx -d ejemplo.com

Hauràs d'anar responent les preguntes de Certbot; pots indicar l'opció de redirect per redirigir el trànsit no segur a segur.

Accedir a la interfície web de Zammad

Ara obre el navegador web i escriu l'URL http: // FQDN or your-server-ip. Se't redirigirà a la pàgina següent:

Fes clic al botó 'Configurar nuevo sistema', hauries de veure la pàgina següent:

Proporciona el nom d'administrador, el correu electrònic i la contrasenya i fes clic al botó 'Crear'. Se't redirigirà a la pàgina següent:

Proporciona el nom de la teva organització i l'URL del sistema, carrega el logotip i fes clic al botó 'Siguiente'.

Tria un mètode d'enviament de correu electrònic adequat i fes clic al botó ‘Continuar’. 

Ara fes clic al botó 'Omitir' per finalitzar la instal·lació. Hauries de veure el tauler de control del panell de Zammad:

Enhorabona! Has instal·lat i configurat el sistema de tiquets Zammad al servidor Ubuntu 20.04 LTS.

Ara pots implementar fàcilment Zammad en un entorn de producció.