Synchronisation depuis l'annuaire fédérateur Mise en place de la synchronisation des fichiers AAF juin 2010
V e r s i o n d u d o c u m e n t j u i n 2 0 1 0 D a t e c r é a t i o n : j u i n 2 0 1 0 E d i t e u r P ô l e d e c o m p é t e n c e E O L E R é d a c t e u r s L i c e n c e Équipe EOLE Cette documentation, rédigée par le pôle de compétence EOLE, est mise à disposition selon les termes de la licence : Creative Commons Paternité Pas d'utilisation Commerciale Partage des Conditions Initiales à l'identique 2.0 france : http://creativecommons.org/licenses/by nc sa/2.0/fr/. Vous êtes libres : de reproduire, distribuer et communiquer cette création au public ; de modifier cette création Selon les conditions suivantes : paternité : vous devez citer le nom de l'auteur original de la manière indiquée par l'auteur de l'oeuvre ou le titulaire des droits qui vous confère cette autorisation (mais pas d'une manière qui suggèrerait qu'ils vous soutiennent ou approuvent votre utilisation de l'œuvre) ; pas d'utilisation Commerciale : vous n'avez pas le droit d'utiliser cette création à des fins commerciales, y compris comme support de formation ; partage des Conditions Initiales à l'identique : si vous modifiez, transformez ou adaptez cette création, vous n'avez le droit de distribuer la création qui en résulte que sous un contrat identique à celui ci. A chaque réutilisation ou distribution de cette création, vous devez faire apparaître clairement au public les conditions contractuelles de sa mise à disposition. La meilleure manière de les indiquer est un lien vers cette page web. Chacune de ces conditions peut être levée si vous obtenez l'autorisation du titulaire des droits sur cette œuvre. Rien dans ce contrat ne diminue ou ne restreint le droit moral de l'auteur ou des auteurs. Cette documentation est basée sur une réalisation du pôle EOLE. Les documents d'origines sont disponibles sur le site du pôle. EOLE est un projet libre (Licence GPL). Il est développé par le Pôle de Compétence EOLE du Ministère de l'éducation nationale, rattaché au Centre d'etudes et de Traitements Informatiques de l'académie de Dijon (CETIAD). Pour toute information concernant ce projet vous pouvez nous joindre : Par courrier électronique : eole@ac dijon.fr Par FAX : 03 80 44 88 10 Par courrier : EOLE CETIAD 33 rue Berbisey B.P. 1557 21032 DIJON CEDEX le site : http://eole.orion.education.fr 2
I Sommaire S o m m a i r e 3
II Préambule P r Fonctionnement général de la synchronisation 1. la machine ODI génère une archive tar.gz par établissement à synchroniser ; 2. dès l'archive terminée, elle est envoyée sur Zéphir accompagnée d'une notification ; 3. Zéphir envoie l'archive sur le Scribe auquel elle a été associée ; 4. le Scribe lance l'import de l'archive (mode automatique) ou la stocke pour l'ead (mode manuel). Envoi des fichiers sur Zéphir Les archives générées (de la forme <numéro_uai>.tar.gz) doivent être envoyés 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 à Zéphir. Cela peut être fait par les lignes de python suivantes : import xmlrpclib z = xmlrpclib.server("https://user:password@adresse_zephir:7080") z.aaf.notify_upload('numerouai.tar.gz') Association archive Scribe L'association d'un Scribe avec son archive se fait pour l'instant manuellement, à l'aide du code python suivant : import xmlrpclib z = xmlrpclib.server("https://user:password@adresse_zephir:7080") z.aaf.add_file(58, '0000001a.tar.gz') Dans cet exemple, on associe l'archive 0000001a.tar.gz au serveur Scribe possédant l'identifiant Zéphir n 58. Pour briser, une association, il faut utiliser : z.aaf.del_file('0000001a.tar.gz') Gestion de l'archive sur Scribe Dès que Zéphir est notifié de l'arrivée d'une nouvelle archive, il prépare son envoi au serveur Scribe qui lui est associé (sauf si l'archive possède la même signature que sa version précédente). Le Scribe récupère l'archive lors de sa connexion à Zéphir. Il est possible de configurer la façon dont Scribe 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 Openldap, Mode de synchnonisation AAF : automatique : l'importation des fichiers est lancée dès leur réception ; manuel : l'archive est stockée et l'importation est prête à être lancée par l'ead (menu Outils / Synchronisation AAF). 4
Synchronisation depuis l'annuaire fédérateur P r Suivi de la synchronisation et de l'importation Agent Zéphir Écran 1 Importation des fichiers AAF synchronisés via l'eadimportation des fichiers AAF synchronisés via l'ead Un agent Zéphir permet de vérifier le bon déroulement de l'envoi des fichiers sur Scribe. Écran 2 L'agent de surveillance de la synchronisation des fichiers AAFL'agent de surveillance de la synchronisation des fichiers AAF Application web Zéphir Des informations sont également disponibles en allant dans Logs complets depuis la page d'état de l'un des serveur Scribe et en filtrant sur divers. 5
Synchronisation depuis l'annuaire fédérateur P r Écran 3 Surveillance de la prise en compte des fichiers AAF dans ZéphirSurveillance de la prise en compte des fichiers AAF dans Zéphir Rapports d'importation 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 habituels : 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 ; logs complets : /var/log/eole/importation.log. Synchronisation depuis l'annuaire fédérateur 6