Source : https://docs.zammad.org/en/latest/install/elasticsearch.html
#### ***Installation*** ```bash #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. ```bash #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. ```bash #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*** ```bash #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 *** ```bash #Installation de Zammad apt update apt install zammad ``` ## **C - Connexion à Zammad :** ```bash #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 ```bash 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 `vi`ou `nano`). ```bash 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. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/77dimage.png)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.[](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/2023-12-07-10-07-36-edition-page-02-installation-wiki-morbihan-energies.png)
#### *** Configuration du ****** conteneur*** Après avoir édité le fichier de configuration de Zammad , il est nécessaire de modifier également celui du conteneur LXC . ```bash #Configuration du conteneur LXC lxc config edit {CT_Name} ``` Une fois dans le fichier de conf, supprimez la ligne "devices \[ \]" et remplacez le par : ```bash 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. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/zammad-web.png) Après avoir cliqué sur "Set ip a new system", il vous faudra créer un compte administrateur. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/02-compte-admin-zammad.png) Ensuite, vous devrez remplir le nom et le logo de l'organisation. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/mT303-organisation.png) Maintenant, vous devrez configurer la notification par e-mail. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/04-notif-email.png) Ici, vous avez le choix de connecter les canaux ou bien de passer afin d'utiliser Zammad au plus vite. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/05-parametrage-canaux.png) Si vous choisissez de connecter les canaux, vous devrez remplir le compte email. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/06-email.png) Puis pour finir, vous devrez remplir l'email entrant. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/07-email-entrant.png) Une fois toutes ces étapes finies, l'installation de votre Zammad est terminée et vous n'avez plus cas l'utiliser ! # 03 - Exploitation ## **A-Interface :** Après avoir installé Zammad, pour utiliser ses nombreuses fonctionnalités, vous devrez dans un premier temps vous connecter avec les identifiants créés au préalable. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/01-connexions.png) Après vous être connecté, vous arriverez sur l'interface ci-dessous : [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/02-interface-web.png) 01- Le point numéro 1 permet la création de ticket. 02- La page aperçue est une page qui permet de voir l'ensemble des tickets de manière classée 03- Comme on peut le voir ci-dessus le point numéro 3 est le tableau de bord, il permet de voir statistiques différentes de la gestion des tickets. 04-Le point 4 est le flux d'activité, il permet de voir les différentes actions qui ont été faites comme la création d'un utilisateur ou d'un ticket. 05- Le point numéro 5 définit l'emplacement des paramètres. 06- En 6, vous pourrez voir les statistiques des différents tickets de la création à la fermeture. 07- Le point 7 vous permettra de personnaliser votre profil. ## **B - Création d'un Utilisateur :** Pour créer un utilisateur, vous devrez tout d'abord aller dans les paramètres situés en bas à gauche de votre interface. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/03-parametre.png) Une fois dans cette interface, vous n'aurez plus cas cliquer sur "Nouvel Utilisateur". [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/04-nouvel-utilisateur.png) Après cela, vous n'avez plus cas définir les informations ainsi que les autorisations qu'il va avoir. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/05-role.png) ## **C - Création de ticket :** Pour créer un ticket, il vous suffit de cliquer sur la croix verte en bas à droite de l'interface de Zammad. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/06-creation-ticket.png) Vous arriverez ensuite sur l'interface ci-dessous ou il vous suffira de remplir votre ticket. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/07-parametre-tcket.png) ## **D - Gestion des billets :** Pour gérer les différents tickets, vous devez aller dans l'onglet aperçu et vous pourrez y voir l'intégralité des tickets qui sont créés. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/08-gestion-de-ticket.png) Une fois le ticket visible, vous pouvez cliquer dessus pour l'ouvrir. Sur la partie de droite, vous pouvez indiquer qui est le propriétaire du ticket, l'état du ticket ainsi que sa priorité. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/28bimage.png) Lorsque vous cliquez sur la zone de texte, vous avez la possibilité d'envoyer un message ou bien de créer une note. Si vous voulez que votre message soit visible par le créateur du ticket, il faut que les chaînes de gauche soient déverrouillées, dans le cas contraire, le message aura une lueur orange et ne pourra pas être vu par le client. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/FIiimage.png) ## **E - Création des Organisations :** ### **1. Création de l'organisation** En allant dans les paramètres de Zammad, vous avez un onglet nommé organisations. Cet onglet vous permet de créer des organisations qui peuvent être ajoutées à différents utilisateurs. Pour cela a commencé par cliquer sur l'onglet "Nouvelle Organisation". [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/1sJimage.png) Vous arriverez ensuite sur l'interface ci-dessous ou vous pourrez remplir les paramètres de votre organisation. Pour valider vos organisations, vous n'aurez plus cas, cliquez sur envoyer. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/zDpimage.png) ### **2. ****Attribution**** de l'organisation** Une fois créé, vous pouvez affecter un utilisateur à votre organisation. Pour cela, allez dans les paramètres puis dans l'onglet utilisateur, cliquez sur votre utilisateur. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/JEUimage.png) Une fois dans l'interface ci-dessous complétée l'onglet "Organisation" avec le nom de l'organisation créée au paravent. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/IGCimage.png) Une fois ajouter votre utilisateur sera ajouter à l'organisation et cela sera précisé dans son profil utilisateur. ## **F - Configuration de Zammad :** Pour les étapes suivantes, nous avons le service Infra, DEV et SIG qui doivent recevoir leurs tickets. Chaque service doit pouvoir attribuer un ticket à l'un de ses membres, ils doivent également pouvoir déléguer un ticket à un autre service. ### **1.Groupe** Pour commencer, il faut tout d'abord créer un groupe avec les différents services. #### ***Création des groupes 1*** Dans un 1er temps, vous allez créer un premier groupe de service, vous devrez vous rendre dans l'onglet "Groupe" situé dans les paramètres. Vous devrez ensuite cliquer sur un nouveau groupe. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/ke4image.png) Une fois dans l'interface ci-dessous, vous n'aurez plus cas nommé votre manager et le créé. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/Qw0image.png) Une fois votre premier service créé, vous n'avez plus cas faire la même chose pour les autres. #### ***Ajout d'utilisateur dans le groupe 2*** Si vous souhaitez ajouter un utilisateur au groupe, vous devrez vous diriger dans l'onglet utilisateur cliqué sur l'utilisateur. Vous arriverez ensuite sur l'utilisateur. interface ci-dessous ou vous n'aurez plus cas choisir le groupe a associer et les permissions accordées, dans notre cas toutes les permissions au groupe. N'oubliez pas de cliquer sur ajouter pour enregistrer ! [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/RWbimage.png) #### ***Délégation de tâche****** 3*** Afin que chaque groupe puisse se transférer des billets, il est important qu'un opérateur possède des droits sur chaque groupe. Des permissions "totale" dans le groupe de son service et seulement les autorisations de modification pour les autres services. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/hCzimage.png) On peut voir ici que cet utilisateur fait partie du service Infra. ### **2. Rôles** Par défaut dans Zammad, il y a 3 rôles : - Administrateur - Opérateur - Client Ici pour chaque membre des services Ifra, DEV et SIG nous allons leur mettre des droits d'opérateur afin qu'ils puissent gérer leur ticket. #### ***Création des Rôles 1*** Dans notre cas, les rôles fournis par Zammad ne seront pas suffisants, c'est pour cela que nous allons commencer par dupliquer 2 fois le rôle "Opérateur". Pour dupliquer un rôle allez dans l'onglet rôle et sélectionnez le logo de droite. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/ApYimage.png) Une fois dupliquer, vous pouvez les renommées en cliquant dessus et en modifiant simplement le nom. #### ***Ajout des droits opérateur 2*** Une fois nos 3 rôles créés, il faut ajouter les utilisateurs. Pour cela, allez au même endroit que pour associer un groupe et ajouter l'opérateur à son service. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/RdJimage.png) On peut voir ici que l'opérateur fait partie du groupe SIG. ### **3. Aperçu** Si ce n'est pas déjà le cas, vous devrez ajouter vos différents rôles au aperçu afin que chaque rôle puisse voir les différentes catégories de ticket. Pour cela aller dans l'onglet "Aperçu" et sélectionné les 3 petits points, vous n'aurez plus cas ajouter les différents rôles. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/SP9image.png) ### **4. Vérification** Après ces différentes étapes, quand vous vous rendez dans les paramètres d'un utilisateur, vous devriez avoir ceci. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/INkimage.png) Si c'est le cas, vos 3 services sont prêts, si un client a créé un ticket, il pourra choisir l'un des 3 services pour envoyer le ticket. Du côté de l'opérateur, il est possible de choisir un responsable de ticket et il est également possible de pouvoir changer le ticket de service. ## **G - Configuration de l'email :** Afin que les utilisateurs puissent envoyer un ticket sans passer par l'interface web, il est possible de configurer des adresses emails qui transfèreront leurs mails à Zammad. Pour commencer, allez dans l'onglet e-mail et cliquer sur "Nouveau". [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/E2dimage.png) Vous arriverez dans l'interface ci-dessous ou vous devrez remplir les différentes informations de l'adresse mail qui va recevoir les différents tickets. [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/FvXimage.png) Après avoir cliqué sur connecter, il vous affichera un message d'erreur et d'autre information à complété. Remplissez le nom d'hôte, ici "imap.morbihan-energies.fr" et sélectionné "Pas de SSL". [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/XiKimage.png) Une fois ces informations remplie, valider vos paramètres et votre email sera relié à Zammad. # 04 - Maintenance ## **A - Mises à jours :** ### **1. Mise à jour Zammad :** Si vous souhaitez mettre à jour votre système Zammad, vous devrez commencer par stopper le service. ```bash #Arrêtez Zammad systemctl stop zammad ``` Une fois Zammad arrêtez vous devrez commencer par vider le cash. ```bash #Vider le cache Zammad zammad run rails r "Rails.cache.clear" ``` Une fois ces étapes effectuées, il ne vous reste plus cas mettre à jour Zammad. ```bash #Mettre à jour Zammad apt update apt upgrade ``` ## **B-Entretien :** ### **1. Création Sauvegarde :** Avant de pouvoir exécuter une sauvegarde ou une restauration, les scripts vous demandent de fournir un fichier de configuration. Nous expédions un `config.dist` dans les `/opt/zammad/contrib/backup` répertoire que vous pouvez simplement renommer. Pour ce faire, exécutez les commandes suivantes en tant qu'utilisateur `root` ou `zammad`. ```bash cd /opt/zammad/contrib/backup/ mv config.dist config ``` ```bash #Création de la Backup /opt/zammad/contrib/backup/zammad_backup.sh ``` [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/4sUimage.png) ### **2. ****Restauration**** d'une sauvegarde :** ```bash #Restoration d'une Backup /opt/zammad/contrib/backup/zammad_restore.sh ``` [](https://wiki.morbihan-energies.fr/uploads/images/gallery/2023-12/MfOimage.png)