Distribution EOLE » Modules » Zéphir » eole-zephir-medde

h1. Principe de fonctionnement

Le paquet eole-zephir-medde sert à alimenter le Zephir avec les informations des modules eSBL & eCDL.

Il contient à minima les dictionnaires et les fonctions nécessaires pour pouvoir déclarer un serveur via le frontend Zephir.

Par extension, il peut aussi contenir tous les dictionnaires "hors Eole" nécessaires aux variantes.

*! les dictionnaires portés par Eole ne doivent pas figurer dans ce dépôt ! Ce serait fatal à apt !*

h1. Arborescence dépôt

<pre>

|_ creole

|	|_ funcs

|		|_ creole3

|			|_ mesFonctionsPerso.py

</pre>Ce répertoire sert à stocker l'ensemble des fonctions personnalisées nécessaires à la saisie.

<pre>

|_ zephir

|	|_ default_modules

|			|_ 6

|				|_ ecdl-2.4

|				|_ esbl-2.4

|			|_ 7

|				|_ ecdl-2.4.1

|				|_ ecdl-2.4.1

</pre>Les répertoires 6 et 7 servent à stocker les fichiers contenant les informations de dictionnaires nécessaires par module.

Ces chiffres correspondent respectivement aux versions 2.4 & 2.4.1 d'Eole.

Les fichiers doivent être appelés *nom_module-release*

ex. ecdl-2.4.1

<pre>

|_ zephir

|	|_ dictionnaires

|			|_ 2.4

|				|_ eole

|					|_ eole-ecdl

|					|_ eole-esbl

|			|_ 2.4.1

|				|_ eole

|					|_ eole-ecdl

|					|_ eole-ecdlannuaire

|					|_ eole-esbl

|					|_ supervision-psin

</pre>Ces répertoires correspondent aux noms des paquets d'où sont issus les dictionnaires pour le module.

Ils abritent tous les dictionnaires nécessaires au frontend.

Par exemple, le répertoire

<pre>

|					|_ supervision-psin

</pre>contient

20_psin.xml  49_ocsinventory_agent.xml

h1. Principes d'alimentation

L'alimentation peut se faire de deux manières :

h2. 1 - outils zephir-parc

Le dépôt zephir-parc contient un tas d'outils permettant quasiment d'automatiser la collecte d'informations nécessaires.

Ces outils ne gèrent que les modules et pas les variantes.

Sur un serveur installé, mis *à jour* de sa version et *instancié*

<pre>

git clone https://dev-eole.ac-dijon.fr/git/zephir-parc.git

cd zephir-parc/outils

</pre>

Ce répertoire contient un script shell zephir_dicts.sh qui, lancé sur le module, va générer une archive sous /tmp (Cette opération est donc à répéter sur un serveur de chaque module)

L'archive est organisée de la manière suivante (cas d'un eCDL) :

<pre>

ecdl-2.4.1.paqs

|_ eole

|	|_ eole-antivirus

|	|_ eole-client-annuaire

|	|_ eole-ead-common

|	|_ eole-ecdl

|	|_ eole-ecdlannuaire

|	|_ eole-exim

|	|_ eole-fichier-common

|	|_ eole-fichier-primaire

|	|_ eole-flask

|	|_ eole-nut

|	|_ eole-server

|	|_ eole-userpassword

|	|_ supervision-psin

</pre>

fichier nommodule-release

Le fichier *ecdl-2.4.1.paqs* correspond au fichier *nom_module-release* vu précédemment et doit être renommé *sans* l'extension .paqs.

Soit ici ecdl-2.4.1.paqs devient ecdl-2.4.1

De plus, il *doit* subir une modification nécessaire pour indiquer si le module concerné est en mode conteneur ou pas :

mode *non conteneur* : ajout de la ligne: eole/eole-zephir-module

mode *conteneur* : eole/eole-zephir-module-container

Reste alors à le placer au bon endroit sur le dépôt soit ici : _eole-zephir-medde/zephir/default_modules/7/ecdl-2.4.1_

répertoires de dictionnaires

L'archive se comporte comme l'arborescence du dépôt. On obtient des répertoires qui correspondent à des paquets et contenant des dictionnaires.

Ils devront être ajoutés au dépôt à l'endroit adéquat sous */zephir/dictionnaires/release* soit ici : _eole-zephir-medde/zephir/dictionnaires/2.4.1/_

*Rappel : dans le cadre des modules MEDDE traités ici, il faut purger tous les dicos portés par Eole et ne pas les ajouter sous peine de casser apt*

h2. 2 - Méthode automatique type EN

Un script parse l'ensemble des dicos de tous les dépôts et alimente le paquet des dictionnaires zephir EN automatiquement.

Il reste à développer ET tester au MEDDE

h2. 3 - A la main ...

Pour chaque dépôt à jour concerné, récupérer de chaque branche (2.4, 2.4.1 ...), l'ensemble des dicos en n'oubliant pas de préciser le nom du paquet pour le répertoire.

Ou, à chaque modification de dictionnaire, se poser la question *"Et le Zephir dans tout ça ?"* et prendre le réflexe d'alimenter ce dépôt systématiquement et correctement.