02 - Installation

A - Préparation à l'installation :

https://docs.zammad.org/en/latest/install/package.html

https://docs.zammad.org/en/latest/install/elasticsearch.html#configure-zammad-with-elasticsearch

https://docs.zammad.org/en/latest/getting-started/configure-webserver.html

1. Prérequis :

Tout d'abord, pour le bon fonctionnement de Zammad il vous faudra installer Postfix.

#Installation postfix
apt install postfix

2. Installation de la dépendances du forfait :

Les dépendances ci-dessous doivent être installées sur votre système.

#Installation des dépendances du package
apt install curl apt-transport-https gnupg

3. Configuration d'Elasticsearch :

Source : https://docs.zammad.org/en/latest/install/elasticsearch.html

Installation

#Installation d'Elacticsearch

apt install apt-transport-https sudo wget curl gnupg

echo "deb [signed-by=/etc/apt/trusted.gpg.d/elasticsearch.gpg] https://artifacts.elastic.co/packages/7.x/apt stable main"| \
  tee -a /etc/apt/sources.list.d/elastic-7.x.list > /dev/null

curl -fsSL https://artifacts.elastic.co/GPG-KEY-elasticsearch | \
  gpg --dearmor | tee /etc/apt/trusted.gpg.d/elasticsearch.gpg> /dev/null

apt update

apt install elasticsearch

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

Après avoir installé Elasticsearch et son plugin de pièce jointe, assurez-vous de l'activer par défaut et démarrez-le.

#Démarrage d'Elasticsearch
systemctl start elasticsearch
systemctl enable elasticsearch

4. Vérification des paramètres régionaux :

Pour que Zammad fonctionne correctement, votre système doit utiliser les paramètres régionaux corrects.

#Répertoriez vos paramètres régionaux actuels
apt install locales
locale-gen fr_FR.UTF-8
echo "LANG=fr_FR.UTF-8

B - Installation de Zammad :

Ajout d'un référentiel

#Installer la clé référentiel
curl -fsSL https://dl.packager.io/srv/zammad/zammad/key | \
  gpg --dearmor | tee /etc/apt/trusted.gpg.d/pkgr-zammad.gpg> /dev/null

#Ubuntu 22.04 
echo "deb [signed-by=/etc/apt/trusted.gpg.d/pkgr-zammad.gpg] https://dl.packager.io/srv/deb/zammad/zammad/stable/ubuntu 22.04 main"| \
   tee /etc/apt/sources.list.d/zammad.list > /dev/null

       Installation de Zammad 

#Installation de Zammad
apt update
apt install zammad

C - Connexion à Zammad :

#Définir l'adresse du serveur Elasticsearch
zammad run rails r "Setting.set('es_url', 'http://localhost:9200')"

#Construire l'index de recherche
zammad run rake zammad:searchindex:rebuild

D - Configuration des fichiers de conf :

     Obtenez un fichier de configuration actuelle

Copiez et écrasez la valeur par défaut  zammad.conf en utilisant

cp /opt/zammad/contrib/nginx/zammad_ssl.conf /etc/nginx/sites-available/zammad.conf

       Ajustez le fichier de configuration

Ajustez le fichier que vous venez de copier avec un éditeur de texte de votre choix (par exemple  viou  nano).

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

Localisez n'importe quelle server_name directive et ajustez example.com la au sous-domaine que vous avez choisi pour votre instance Zammad.

Pour que le serveur soit opérationnel, il est important de supprimer toute la partie ssl du fichier de conf étant donné que c'est le proxy qui prendra en charge le ssl.

     Configuration du  conteneur

Après avoir édité le fichier de configuration de  Zammad , il est nécessaire de modifier également celui du conteneur  LXC .

#Configuration du conteneur LXC
lxc config edit {CT_Name}

Une fois dans le fichier de conf, supprimez la ligne "devices [ ]" et remplacez le par : 

devices:
 eth0:
  ipv4.address: {adresse ip du conteneur}
  name: eth0
  network: lxdbr1
  type: nic
port22215:
  connect: tcp:0.0.0.0:22
  listen: tcp:192.168.56.190:22215
  type: proxy
port44215:
  connect: tcp:0.0.0.0:80
  listen: tcp:192.168.56.190:44215
  type: proxy

Attention, pensez à bien modifier l'adresse Ip ainsi que les différents ports.

E - Configuration du Serveur Web :

Une fois arrivé sur la page ci-dessous, la configuration peut commencer.

Après avoir cliqué sur "Set ip a new system", il vous faudra créer un compte administrateur.

Ensuite, vous devrez remplir le nom et le logo de l'organisation.

Maintenant, vous devrez configurer la notification par e-mail.

Ici, vous avez le choix de connecter les canaux ou bien de passer afin d'utiliser Zammad au plus vite.

Si vous choisissez de connecter les canaux, vous devrez remplir le compte email.

Puis pour finir, vous devrez remplir l'email entrant.

Une fois toutes ces étapes finies, l'installation de votre Zammad est terminée et vous n'avez plus cas l'utiliser !