Comment installer le système de support client Zammad sur Rocky Linux 9

Zammad est une solution de support client / billetterie open-source basée sur Ruby et PostgreSQL. Elle aide les organisations à gérer les communications à travers divers canaux d’email, de chat et de médias sociaux.

Dans ce guide, vous apprendrez à installer le système de billetterie Zammad sur le serveur Rocky Linux. Vous exécuterez Zammad avec PostgreSQL, Nginx et Elasticsearch.

Prérequis

Avant de commencer, assurez-vous d’avoir les éléments suivants :

• Un serveur Rocky Linux 9.
• Un utilisateur non-root avec des privilèges d’administrateur.
• Un nom de domaine pointé vers une adresse IP de serveur.
• Un SELinux avec un statut permissif.

Installation des dépendances

Dans cette section, vous installerez les dépendances pour Zammad, cela inclut le dépôt EPEL, la base de données PostgreSQL, le serveur web Nginx, Redis et Node.js.

Tout d’abord, ajoutez le dépôt EPEL à votre système Rocky Linux avec la commande suivante.

sudo dnf install epel-release -y

Maintenant, configurez la locale par défaut sur en_US.UTF-8 avec la commande ci-dessous.

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

Exécutez maintenant la commande ci-dessous pour activer le dépôt Node.js pour la version 18.

sudo dnf module enable nodejs:18 -y

Ensuite, exécutez la commande dnf ci-dessous pour installer les dépendances pour Zammad, y compris Nginx, PostgreSQL, Redis et Node.js.

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

Entrez y pour confirmer et continuer.

Après l’installation, exécutez la commande ci-dessous pour initialiser le serveur PostgreSQL.

sudo postgresql-setup initdb

Démarrez et activez les services pour Nginx, PostgreSQL et Redis avec la commande ci-dessous.

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

Enfin, vérifiez la version de Node.js en utilisant la commande ci-dessous. Assurez-vous d’avoir Node.js 18.0+ installé.

node --version

Installation d’Elasticsearch

Après avoir installé les dépendances, vous devrez installer Elasticsearch. Dans cette section, vous installerez Elasticsearch 7.x pour Zammad.

Exécutez maintenant la commande ci-dessous pour ajouter la clé GPG pour le dépôt Elasticsearch.

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

Ajoutez le dépôt Elasticsearch pour le serveur Rocky Linux avec la commande suivante.

echo "[elasticsearch-7.x]  
name=Elasticsearch repository for 7.x packages  
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

Ensuite, installez Elasticsearch sur votre système avec la commande suivante. Entrez y pour confirmer l’installation et acceptez la clé GPG lorsque vous y êtes invité.

sudo dnf install elasticsearch

Après l’installation, installez le plugin ingest-attachment à votre installation Elasticsearch en utilisant la commande ci-dessous.

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

Entrez y pour confirmer l’installation.

Maintenant, rechargez le gestionnaire systemd et démarrez le service elasticsearch en utilisant la commande ci-dessous.

sudo systemctl daemon-reload  
sudo systemctl start elasticsearch

Une fois démarré, vérifiez Elasticsearch avec la commande curl ci-dessous. Si votre installation est réussie, vous obtiendrez des informations détaillées sur votre version d’Elasticsearch.

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

Augmenter le nombre maximal de connexions dans PostgreSQL

Pour PostgreSQL, vous devez augmenter le max_connections par défaut dans le fichier postgresql.conf. Cela est nécessaire pour Zammad.

Connectez-vous en tant qu’utilisateur postgres avec la commande ci-dessous.

su - postgres

Ouvrez la configuration PostgreSQL data/postgresql.conf en utilisant l’éditeur nano.

nano data/postgresql.conf

Changez le max_connections par défaut à 2000 comme suit :

max_connections = 2000

Enregistrez le fichier et quittez.

Exécutez maintenant la commande systemctl ci-dessous pour redémarrer le service PostgreSQL et appliquer vos modifications.

sudo systemctl restart postgresql

Configuration de Firewalld

Par défaut, firewalld est activé sur Rocky Linux. Vous devez donc maintenant ouvrir les services HTTP et HTTPS et autoriser le trafic vers Zammad.

Ajoutez les services HTTP et HTTPS à firewalld en utilisant la commande suivante.

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

Rechargez maintenant firewalld pour appliquer les nouvelles règles pour HTTP et HTTPS.

sudo firewall-cmd --reload

Vérifiez la liste des règles sur firewalld en utilisant la commande ci-dessous. Vous verrez les services HTTP et HTTPS disponibles sur firewalld.

sudo firewall-cmd --list-all

Installation du système de support client Zammad

Maintenant que vous avez installé et configuré les dépendances, vous pouvez commencer l’installation de Zammad, qui peut être effectuée via le gestionnaire de paquets DNF.

Ajoutez la clé GPG pour le dépôt Zammad en utilisant la commande ci-dessous.

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

Ajoutez maintenant le dépôt Zammad à votre serveur Rocky Linux avec la commande suivante.

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

Ensuite, installez zammad avec la commande dnf ci-dessous. Lorsque vous y êtes invité, tapez y pour confirmer la clé gpg et l’installation de Zammad.

sudo dnf install zammad

Après l’installation, exécutez la commande suivante pour vérifier les services pour Zammad, y compris zammad, zammad-web, zammad-worker et zammad-websocket.

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

Assurez-vous que chaque service pour Zammad est en cours d’exécution.

Enfin, exécutez la commande suivante pour configurer l’intégration entre Zammad et Elasticsearch.

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

Après l’exécution de la commande, cela créera un index elasticsearch pour Zammad.

Configuration de Nginx en tant que proxy inverse

Maintenant que vous avez installé Zammad, vous allez configurer Nginx en tant que proxy inverse, et par défaut, Zammad fournit une configuration d’exemple qui est disponible dans le répertoire /opt/zammad/contrib.

Copiez la configuration Nginx pour Zammad dans /etc/nginx/conf.d/zammad.conf et ouvrez-la en utilisant la commande de l’éditeur nano.

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

Dans l’option server_name, changez-la avec votre domaine.

server_name zammad.howtoforge.local;

Enregistrez et quittez le fichier.

Vérifiez maintenant votre configuration Nginx pour vous assurer que vous avez une syntaxe correcte. Si cela réussit, vous devriez obtenir une sortie ‘syntax is ok‘.

sudo nginx -t

Enfin, exécutez la commande ci-dessous pour redémarrer le service Nginx et appliquer une nouvelle configuration de bloc serveur pour Zammad.

sudo systemctl restart nginx

Avec cela, votre installation de Zammad devrait être prête et accessible.

Sécuriser Zammad avec HTTPS

Maintenant que Nginx est configuré, sécurisons Zammad via des certificats SSL/TLS. Vous allez installer Certbot et générer des certificats SSL en utilisant certbot de Letsencrypt.

Installez Certbot et le plugin Nginx en utilisant la commande dnf ci-dessous. Tapez y pour confirmer l’installation.

sudo dnf install certbot python3-certbot-nginx

Après l’installation, exécutez la commande certbot ci-dessous pour générer des certificats SSL/TLS et sécuriser votre installation Zammad. Assurez-vous de changer les informations de l’adresse email et du nom de domaine avec vos informations.

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

Une fois terminé, vos certificats SSL/TLS seront disponibles dans le répertoire /etc/letsencrypt/live/domain.com, et votre Zammad sera également sécurisé avec HTTPS automatiquement.

Configuration de l’installation de Zammad

Lancez votre navigateur web et visitez https://zammad.hwomdian.io/. Si votre installation est réussie, vous serez invité à faire ce qui suit :

Cliquez sur Configurer un nouveau système pour commencer à configurer Zammad.

Entrez les détails de votre utilisateur admin et le mot de passe pour Zammad, puis cliquez sur Créer.

Entrez le nom de votre organisation, téléchargez votre logo, et cliquez sur Suivant pour continuer.

Pour les paramètres d’email, cliquez sur Ignorer. Vous pouvez configurer cela après avoir terminé l’installation.

Vous verrez maintenant le tableau de bord Zammad comme suit.

Conclusion

Félicitations ! Vous avez terminé l’installation du système de billetterie Zammad sur le serveur Rocky Linux 9. Vous avez Zammad fonctionnant avec la base de données PostgreSQL, Nginx en tant que proxy inverse, Elasticsearch, et également sécurisé avec HTTPS via Certbot.