Come installare il sistema di supporto clienti Zammad su Rocky Linux 9

Zammad è una soluzione di supporto clienti/open-source basata su Ruby e PostgreSQL. Aiuta le organizzazioni a gestire le comunicazioni attraverso vari canali email, chat e social media.

In questa guida, imparerai come installare il sistema di ticketing Zammad sul server Rocky Linux. Eseguirai Zammad con PostgreSQL, Nginx ed Elasticsearch.

Prerequisiti

Prima di iniziare, assicurati di avere i seguenti requisiti:

• Un server Rocky Linux 9.
• Un utente non root con privilegi di amministratore.
• Un nome di dominio puntato a un indirizzo IP del server.
• Un SELinux con stato permissivo.

Installazione delle dipendenze

In questa sezione, installerai le dipendenze per Zammad, che includono il repository EPEL, il database PostgreSQL, il server web Nginx, Redis e Node.js.

Per prima cosa, aggiungi il repository EPEL al tuo sistema Rocky Linux con il seguente comando.

sudo dnf install epel-release -y

Ora imposta la locale predefinita su en_US.UTF-8 con il comando qui sotto.

sudo localectl set-locale LC_CTYPE=en_US.UTF-8

Ora esegui il comando qui sotto per abilitare il repository Node.js per la versione 18.

sudo dnf module enable nodejs:18 -y

Successivamente, esegui il comando dnf qui sotto per installare le dipendenze per Zammad, inclusi Nginx, PostgreSQL, Redis e Node.js.

sudo dnf install imlib2 nginx postgresql-server postgresql-contrib libpq-devel redis nodejs

Inserisci y per confermare e procedere.

Dopo che l’installazione è terminata, esegui il comando qui sotto per inizializzare il server PostgreSQL.

sudo postgresql-setup initdb

Avvia e abilita i servizi per Nginx, PostgreSQL e Redis con il comando qui sotto.

sudo systemctl start nginx postgresql redis  
sudo systemctl enable nginx postgresql redis

Infine, controlla la versione di Node.js utilizzando il comando qui sotto. Assicurati di avere installato Node.js 18.0+.

node --version

Installazione di Elasticsearch

Dopo aver installato le dipendenze, dovrai installare Elasticsearch. In questa sezione, installerai Elasticsearch 7.x per Zammad.

Ora esegui il comando qui sotto per aggiungere la chiave GPG per il repository di Elasticsearch.

rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch

Aggiungi il repository di Elasticsearch per il server Rocky Linux con il seguente comando.

echo "[elasticsearch-7.x]  
name=Repository Elasticsearch per pacchetti 7.x  
baseurl=https://artifacts.elastic.co/packages/7.x/yum  
gpgcheck=1  
gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch  
enabled=1  
autorefresh=1  
type=rpm-md"| tee /etc/yum.repos.d/elasticsearch-7.x.repo

Successivamente, installa Elasticsearch sul tuo sistema con il seguente comando. Inserisci y per confermare l’installazione e accetta la chiave GPG quando richiesto.

sudo dnf install elasticsearch

Dopo che l’installazione è terminata, installa il plugin ingest-attachment nella tua installazione di Elasticsearch utilizzando il comando qui sotto.

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

Inserisci y per confermare l’installazione.

Ora ricarica il gestore systemd e avvia il servizio elasticsearch utilizzando il comando qui sotto.

sudo systemctl daemon-reload  
sudo systemctl start elasticsearch

Una volta avviato, controlla Elasticsearch con il comando curl qui sotto. Se la tua installazione è riuscita, riceverai informazioni dettagliate sulla tua versione di Elasticsearch.

curl -X GET 'http://localhost:9200'

Aumentare il numero massimo di connessioni in PostgreSQL

Per PostgreSQL, devi aumentare il valore predefinito di max_connections nel file postgresql.conf. Questo è necessario per Zammad.

Quindi accedi come utente postgres con il comando qui sotto.

su - postgres

Apri il file di configurazione di PostgreSQL data/postgresql.conf utilizzando l’editor nano.

nano data/postgresql.conf

Cambia il valore predefinito di max_connections in 2000 come segue:

max_connections = 2000

Salva il file ed esci.

Ora esegui il comando systemctl qui sotto per riavviare il servizio PostgreSQL e applicare le tue modifiche.

sudo systemctl restart postgresql

Configurazione di Firewalld

Per impostazione predefinita, firewalld è abilitato su Rocky Linux. Quindi ora devi aprire i servizi HTTP e HTTPS e consentire il traffico a Zammad.

Aggiungi entrambi i servizi HTTP e HTTPS a firewalld utilizzando il seguente comando.

sudo firewall-cmd --zone=public --add-service=http --permanent  
sudo firewall-cmd --zone=public --add-service=https --permanent

Ora ricarica firewalld per applicare le nuove regole per HTTP e HTTPS.

sudo firewall-cmd --reload

Controlla l’elenco delle regole su firewalld utilizzando il comando qui sotto. Vedrai entrambi i servizi HTTP e HTTPS disponibili su firewalld.

sudo firewall-cmd --list-all

Installazione del sistema di supporto clienti Zammad

Ora che hai installato e configurato le dipendenze, puoi avviare l’installazione di Zammad, che può essere eseguita tramite il gestore di pacchetti DNF.

Aggiungi la chiave GPG per il repository di Zammad utilizzando il comando qui sotto.

sudo rpm --import https://dl.packager.io/srv/zammad/zammad/key

Ora aggiungi il repository di Zammad al tuo server Rocky Linux con il seguente comando.

sudo wget -O /etc/yum.repos.d/zammad.repo \  
https://dl.packager.io/srv/zammad/zammad/develop/installer/el/9.repo

Successivamente, installa zammad con il comando dnf qui sotto. Quando richiesto, digita y per confermare la chiave gpg e l’installazione di Zammad.

sudo dnf install zammad

Dopo che l’installazione è terminata, esegui il seguente comando per controllare i servizi per Zammad, inclusi zammad, zammad-web, zammad-worker e zammad-websocket.

sudo systemctl status zammad  
sudo systemctl status zammad-web  
sudo systemctl status zammad-worker  
sudo systemctl status zammad-websocket

Assicurati che ogni servizio per Zammad sia in esecuzione.

Infine, esegui il seguente comando per impostare l’integrazione tra Zammad ed Elasticsearch.

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

Dopo l’esecuzione del comando, questo creerà un indice elasticsearch per Zammad.

Configurazione di Nginx come reverse proxy

Ora che hai installato Zammad, configurerai Nginx come reverse proxy, e per impostazione predefinita, Zammad fornisce una configurazione di esempio disponibile nella directory /opt/zammad/contrib.

Copia la configurazione di Nginx per Zammad in /etc/nginx/conf.d/zammad.conf e aprila utilizzando il comando dell’editor nano.

cp /opt/zammad/contrib/nginx/zammad.conf /etc/nginx/conf.d/zammad.conf  
sudo nano /etc/nginx/conf.d/zammad.conf

All’interno dell’opzione server_name, cambiala con il tuo dominio.

server_name zammad.howtoforge.local;

Salva ed esci dal file.

Ora verifica la tua configurazione di Nginx per assicurarti di avere una sintassi corretta. Se hai successo, dovresti ricevere un output ‘syntax is ok‘.

sudo nginx -t

Infine, esegui il comando qui sotto per riavviare il servizio Nginx e applicare una nuova configurazione del blocco del server per Zammad.

sudo systemctl restart nginx

Con questo, la tua installazione di Zammad dovrebbe essere pronta e accessibile.

Sicurezza di Zammad con HTTPS

Ora che Nginx è configurato, mettiamo in sicurezza Zammad tramite certificati SSL/TLS. Installerai Certbot e genererai certificati SSL utilizzando certbot di Letsencrypt.

Installa Certbot e il plugin Nginx utilizzando il comando dnf qui sotto. Digita y per confermare l’installazione.

sudo dnf install certbot python3-certbot-nginx

Dopo che l’installazione è completata, esegui il comando certbot qui sotto per generare certificati SSL/TLS e mettere in sicurezza la tua installazione di Zammad. Assicurati di cambiare le informazioni dell’indirizzo email e del nome di dominio con le tue informazioni.

sudo certbot --nginx --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d zammad.howtoforge.local

Una volta completato, i tuoi certificati SSL/TLS saranno disponibili nella directory /etc/letsencrypt/live/domain.com, e il tuo Zammad sarà anche messo in sicurezza con HTTPS automaticamente.

Configurazione dell’installazione di Zammad

Avvia il tuo browser web e visita https://zammad.hwomdian.io/. Se la tua installazione è riuscita, ti verrà chiesto quanto segue:

Clicca su Configura un nuovo sistema per iniziare a configurare Zammad.

Digita i dettagli del tuo utente admin e la password per Zammad, quindi clicca su Crea.

Digita il nome della tua organizzazione, carica il tuo logo e clicca su Avanti per continuare.

Per le impostazioni email, clicca su Salta. Puoi configurarlo dopo aver terminato l’installazione.

Ora vedrai il dashboard di Zammad come segue.

Conclusione

Congratulazioni! Hai completato l’installazione del sistema di ticketing Zammad sul server Rocky Linux 9. Hai Zammad in esecuzione con il database PostgreSQL, Nginx come reverse proxy, Elasticsearch e anche messo in sicurezza con HTTPS tramite Certbot.