Installation et mise en œuvre du module Scribe

1. la machine ODI^[1] génère une archive tar.gz par établissement à synchroniser ;

2. dès l'archive terminée, elle est envoyée sur le module Zéphir accompagnée d'une notification ;

3. le module Zéphir envoie l'archive sur le module Scribe auquel elle a été associée ;

4. le module Scribe lance l'import de l'archive (mode automatique) ou la stocke pour l'EAD (mode manuel).

L'association d'un module Scribe avec son archive se fait pour l'instant manuellement, à l'aide du code python suivant :

import xmlrpclib

z = xmlrpclib.Server("https://utilisateur:codeSecret@adresse_zephir:7080")

z.aaf.add_file(idZéphir, 'nomArchive.tar.gz')

Pour afficher la liste des archives associées au module Scribe possédant l'identifiant Zéphir idZéphir :

z.aaf.get_list(idZéphir)

Pour supprimer l'association entre l'archive et le module Scribe :

z.aaf.del_file('nomArchive.tar.gz')

Les archives générées (de la forme <numéro_UAI>.tar.gz) doivent être envoyées dans le répertoire : /var/lib/zephir/aaf.

L'envoi des fichiers peut être réalisé par la méthode de votre choix : rsync, scp, ...

Une fois l'archive envoyée, il faut notifier cet envoi au module Zéphir.

Cela peut être fait par les lignes python suivantes :

import xmlrpclib

z = xmlrpclib.Server("https://utilisateur:codeSecret@adresse_zephir:7080")

z.aaf.notify_upload('numeroUAI.tar.gz')

Dès que le module Zéphir est notifié de l'arrivée d'une nouvelle archive, il prépare son envoi vers le module Scribe qui lui est associé (sauf si l'archive possède la même signature que sa version précédente).

Le module Scribe récupère l'archive lors de sa connexion au module Zéphir.

Il est possible de configurer la façon dont le module importe les données de l'archive récupérée.

Cela se paramètre dans l'interface de configuration du module, en mode expert, dans l'onglet Ent.

La variable Mode de synchronisation AAF permet de choisir entre deux modes :

• automatique : l'importation des fichiers est exécutée dès leur réception ;
• manuel : l'archive est stockée et l'importation est prête à être exécuté par l'EAD (menu Outils / Synchronisation AAF).

La variable Envoi d'un courrier électronique en cas d'erreur active l'envoi d'un courrier électronique en cas d'erreur lors de l'import manuel ou automatisé des fichiers AAF. Le ou les destinataires de ce message sont à ajouter dans Adresse(s) électronique(s) à utiliser.

Si le module Scribe est configuré en mode manuel, l'import des archives envoyées sur le module Scribe se réalise à la demande en allant dans l'EAD.

Le formulaire d'import est accessible par le menu Outils / Synchronisation AAF.

Par défaut l'import est réalisé en mode Mise à jour des bases, mais il est possible de l'effectuer en mode Importation annuelle des bases en cochant la case Importer les fichiers en mode "annuel".

• Mise à jour des bases : ajoute les utilisateurs et groupes manquants sans modifier les groupes existants ;

• Importation annuelle des bases : ajoute les utilisateurs et groupes manquants après avoir purgé les options (import des élèves) ou les équipes pédagogiques (import des professeurs).

Un agent Zéphir permet de vérifier le bon déroulement de l'envoi des fichiers sur le module.

Des informations sont également disponibles en allant dans Logs complets depuis la page d'état de l'un des serveurs Scribe et en filtrant sur divers.

L'importation des fichiers AAF synchronisés utilise les même scripts que l'importation habituelle, on retrouve donc les rapports de l'importation AAF aux endroits suivants :

• page d'accueil de l'EAD (/usr/share/ead2/backend/tmp/importation/rapport.txt) ;
• répertoire personnel de l'utilisateur admin : /home/a/admin/perso/importation ;
• journaux complets : /var/log/eole/importation.log.