Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la...

80
Formation technique ORI-OAI Installation et configuration Rennes, 26-27-28 mars 2008

Transcript of Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la...

Page 1: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Formation technique ORI-OAIInstallation et configuration

Rennes, 26-27-28 mars 2008

Page 2: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 2

Sommaire

Fonctionnalités

Architecture

Installation basique

Configuration avancée

Introduction

Page 3: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 3

Introduction

Projet ORI-OAI

Page 4: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 4

Programme de la formation

Organisation 3 jours

26 mars 9h30 28 mars 16h

Public Services informatiques

Pré-requis Avoir un projet d’établissement construit Technologies

Linux, Tomcat, XML, Ant Spring serait un plus

Page 5: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 5

Programme de la formation

Installation et configuration de ORI-OAI version 1.0 Fonctionnalités Architecture Installation basique Configuration avancée

Page 6: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 6

Tour de table

Quelles sont vos objectifs pour cette formation ?

Quel est le projet de votre établissement ?

Avez-vous déjà dans votre établissement une expérience d'archive institutionnelle ou de portail de ressources numériques ?

Envisagez-vous d'utiliser ORI-OAI pour gérer votre projet d'archive institutionnelle ou de portail ?

Page 7: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 7

Tour de table

A quelle étape vous situez-vous dans votre démarche de projet avec ORI-OAI ?

Avez-vous constitué une équipe projet dans votre établissement ? Combien de personnes ?Quels profils ?

Votre niveau de connaissance technique Linux ? Tomcat ? XML ? ANT ?

Page 8: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 8

Futures formations

Besoin de former des personnes relais dans les UNR

Engagement des stagiaires dans notre démarche Les formés organisent des formations régionales Identification des futurs formateurs

Formalisation de l’organisation de ces formations Qui ? Quand ? Où ? À Qui ?

Personnes relais entre les stagiaires régionaux et les développeurs Tous les compléments à la formation peuvent être

donnés sur la liste ori-oai-utilisateurs

Page 9: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 9

Fonctionnalités

Projet ORI-OAI

Page 10: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 10

ORI-OAI – Points clés

Gérer et publier les ressources numériques de l’établissement (ressources pédagogiques, scientifiques…) Référentiel unique de ressources connecté au SI Production de métadonnées et diffusion des

ressources produites par l’établissement

Valoriser la production de l’établissement par une indexation de qualité Indexation avec des normes et standards Utilisation de classifications paramétrables articulés

sur des standards comme Dewey

Page 11: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 11

ORI-OAI – Points clés

Partager les ressources numériques avec d’autres établissements Exposition des fiches de métadonnées de

l’établissement Agrégation de fiches de métadonnées

Accéder aux ressources numériques à distance en fonction des droits d’accès Système de recherche avancée et thématique Définition des droits

Page 12: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 12

ORI-OAI – Intégration au SI

Référentiels partagés

Système d’identification et d’authentification de l’établissement

Intégration dans l’ENT

Page 13: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 13

ORI-OAI – les fonctions

indexation de qualité adaptée aux divers types de documents, classification pivot

sur les métadonnées, texte intégral

en respectant le droit d’auteur, les licences et les droits d’accès

versions de publication, workflows, plusieurs schémas de métadonnées

documents natifs toujours disponiblespour les auteurs

protocole OAI/PMH, fédération d’identités

recherche

diffusion

publication web

archivage

référencement

partage

Page 14: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 14

Architecture

Projet ORI-OAI

Page 15: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 15

Architecture de la version 1.0

ESUP-serveur-WebDAVstockage des documents etgestion des authentifications

ORI-OAI-repositoryentrepôt d’exposition

des métadonnées

ORI-OAI-indexingmoteur d’indexation

ORI-OAI-workflowgestionnaire du workflow

de saisie des métadonnées

ORI-OAI-vocabularygestionnaire de vocabulaires

ORI-OAI-harvestingmoissonneur de métadonnées

ORI-OAI-searchmoteur de recherche

7 modules interopérables

Page 16: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 16

Cas 1: producteur de données

UtilisateursSSO

ESUP-serveur-WebDAVstockage des documents etgestion des authentifications

ORI-OAI-repositoryentrepôt d’exposition

des métadonnées

ORI-OAI-indexingmoteur d’indexation

ORI-OAI-workflowgestionnaire du workflow

de saisie des métadonnées

ORI-OAI-vocabularygestionnaire de vocabulaires

Référencement du lien vers le(s) document(s) Indexation des métadonnées Saisie des métadonnées via vocabulaires

Vocabulaires dynamiques basés sur l’index

Exposition OAI (optionnelle) Exposition des fiches par requêtes sur l’index Génération de sets OAI via le vocabulaire

Page 17: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 17

Cas 2: Agrégateur de données

Internet

ORI-OAI-repositoryentrepôt d’exposition

des métadonnées

ORI-OAI-harvestingmoissonneur de métadonnées

ORI-OAI-indexingmoteur d’indexation

ORI-OAI-vocabularygestionnaire de vocabulaires

Moissonnage des fiches de métadonnées via OAI

Indexation des métadonnées

Exposition OAI (optionnelle) Exposition des fiches par requêtes sur l’index Génération de sets OAI via le vocabulaire

Page 18: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 18

Recherche de documents

ORI-OAI-indexingmoteur d’indexation

ORI-OAI-vocabularygestionnaire de vocabulaires

ORI-OAI-searchmoteur de recherche

Génération des interfaces à partir du vocabulaire

Recherche dans l’index

Traduction de certains résultats via vocabulaire

Page 19: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 19

Les modules

ori-oai-md-editor Saisie des métadonnées Pré-configuré Dublin Core et LOM

ori-oai-workflow Point d’entrée du référencement Processus de publication de fiches Paramétrage très fin Adaptable suivant les besoins Pré-configuré Dublin Core et LOM

Page 20: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 20

Les modules

ori-oai-indexing Indexation des fiches locales et/ou moissonnées issues de fichiers

XML Recherche sur des métadonnées Analyseur suivant la langue Pré-configuré Dublin Core, LOM et CDM

ori-oai-repository Exposition OAI des fiches locales et/ou moissonnées

ori-oai-harvester Moissonnage OAI de fiches de métadonnées

Page 21: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 21

Les modules

ori-oai-search IHM du moteur de recherche Différents modes de recherche Pré-configuré Dublin Core, LOM et CDM

ori-oai-vocabulary Gestionnaire de tous les vocabulaires

Libellés, classifications, listes déroulantes, etc. Hub de référentiels/vocabulaires Différents types de vocabulaire

Statiques, dynamiques: LDAP, SQL, indexing, etc.

Page 22: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 22

Les modules

ESUP-serveur-WebDAV Solution de stockage des ressources Connexion au SSO Fédération d’identités (shibboleth) Connexion possible à l’ENT

Page 23: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 23

La connexion inter-modules

Web services entre chaque module

Possibilité de « débrancher » un module ou de venir se « brancher » depuis une application tierce

Protection des URL d’accès à certains WS

Page 24: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 24

Installation basique

Projet ORI-OAI

Page 25: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 25

Projet ORI-OAI

Environnement de la formation

Page 26: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 26

Environnement lors de la formation

MySql distant sur un serveur avec 1 base par stagiaire

Machines linux avec JDK + SVN + éditeurs de texte (vi et emacs)

Un fichier formationORI.zip est à disposition Annuaire ldap (openDS) Ldapbrowser Un apache tomcat avec l’application eXist (BD XML) Tous les tomcats (attention : les fichiers server.xml doivent être

modifiés pour correspondre aux bons numéros de ports) Apache ANT => lire le readme.txt et penser aux variables d’environnement

env.sh

Page 27: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 27

Variables d’installation

Les variables ORI_HOME = /tmp/ORI JAVA_HOME = /usr/local/jdk1.5

LDAP localhost:1389 users

jack/auth, joe/adm, william/mod Dans ou=people,dc=demo,dc=ori-oai,dc=org

SQL une base MySql par poste (en InnoDB!) sur un serveur

mysql de Rennes1 distant

Page 28: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 28

Subversion

Le principe Status, diff, info, switch

Le pourquoi Maintenabilité

LA commande de base Checkout

=> svn co http://subversion.cru.fr/ori-oai-commons/docs !

Page 29: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 29

TP 1

Mise en place de l’environnement

Page 30: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 30

TP 1

Dézipper l’archive récupérée via subversion > unzip formationORI.zip

Lire le readme.txt Variables d’environnements

> export CATALINA_OPTS="-Dfile.encoding=UTF-8 $CATALINA_OPTS" > export JAVA_HOME=/usr/local/jdk1.5> export ANT_HOME=????> export ORI_HOME=/tmp/ori (ici pour infos : $ORI_HOME est

utilisée dans les slides) attention à la portée des variables d’environnement (session terminal, etc.) => ajout dans le .bashrc [ou .tcshrc etc…].

Si vous le souhaitez, vous pouvez aussi modifier votre environnement : nombre de bureaux virtuels, etc.

Page 31: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 31

TP 1

Copier le contenu de l’archive dans $ORI_HOME> cp -r formationORI/* $ORI_HOME

Lancer openDS> cd $ORI_HOME/openDS/bin> sh start-ds Vérifier avec ldapBrowser que le LDAP fonctionne> sh lbe.sh

Modifier la configuration d’eXist> emacs $ORI_HOME/tomcat-exist/webapps/exist/WEB-INF/conf.xml Dans la balise indexer, passer validation de auto à no

Page 32: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 32

TP 1

Accès aux serveurs tomcat Note si besoin changer les droits dans le répertoire bin de tomcat: > cd $ORI_HOME/tomcat-*/bin> chmod a+x *.sh

Lancement des serveurs tomcat> cd $ORI_HOME/tomcat-*/bin> sh catalina.sh run En production, lancer sh startup.sh Vérifier que vous obtenez « server startup »

Page 33: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 33

TP 2

Installation de ori-oai-indexing

Page 34: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 34

TP 2

Introduction Besoin des modules harvester et workflow

Installation Checkout Répertoires

Configuration Modif du build.properties ConfigIndexing.xml

Rep index Rep fic temporaires url des modules harvester et workflow

Déploiement Tests

ant testIndex et ant testSearch=> testIndex ajoute une entrée dans l’index, pour la supprimer, penser à supprimer l’index

==> On supprime l’index

Page 35: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 35

TP 2

Dans $ORI_HOME, création du répertoire qui contiendra l’index d’ori-oai-indexing mkdir –p ${ORI_HOME}/data/indexes/index mkdir ${ORI_HOME}/data/indexes/tmp Depuis src :

svn checkout http://subversion.cru.fr/orioai-indexing/tags/1.0.1 ori-oai-indexing-svn Depuis ori-oai-indexing-svn

Modif du build.properties Modif du properties/configIndexing.xml

[rép. Index, fichiers tmp, urls/modules distants] Modif du log4j.properties (rép logs du tomcat ) ${ANT_HOME}/bin/ant all

Depuis tomcat-indexing/bin, on lance le tomcat sh catalina.sh run

Test de l’URL : http://localhost:8182/ori-oai-indexing/xfire/IndexingService?wsdl Depuis ori-oai-indexing-svn, on peut lancer (pour test)

${ANT_HOME}/bin/ant testIndex (attention : écriture dans l’index) ${ANT_HOME}/bin/ant testSearch

Supprimer l’index (stopper tomcat) : rm –r ${ORI_HOME}/data/indexes/index/*

Page 36: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 36

TP 3

Installation de ori-oai-vocabulary

Page 37: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 37

TP 3

Introduction Peut utiliser le module indexing, un ldap …

Installation Checkout

Configurations Modif du build.properties main-config.properties

url ldap url module indexing Les urls des modules vocabulary distants ne sont pas à modifier …

Déploiement Tests

Page 38: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 38

TP 3

Depuis src : svn checkout http://subversion.cru.fr/ori-vocabulary/ori-oai-vocabulary-spring/tags/ori-oai-vocabulary-1.0.0 ori-oai-vocabulary-svn

Depuis ori-oai-vocabulary-svn Modif du build.properties Modif du conf/properties/main-config.properties

[ldap, exceptions, smtp, indexing] ${ANT_HOME}/bin/ant deploy

Depuis tomcat-vocabulary/bin, on lance le tomcat sh catalina.sh run

Test de l’URL : http://localhost:8183/ori-oai-vocabulary/xfire/OriVocabularyService?wsdl

Depuis ori-oai-vocabulary-svn, on peut lancer (pour test) ${ANT_HOME}/bin/ant vocabularytests

=> tests ok si failures = 0

Page 39: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 39

TP 4

Installation de ori-oai-search

Page 40: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 40

TP 4

Dépendances des modules Besoin de ori-oai-indexing et ori-oai-vocabulary

Téléchargement des sources> cd $ORI_HOME> svn checkout http://subversion.cru.fr/ori-oai-search/tags/1.0.1

ori-oai-search-svn> cd $ORI_HOME/src/ori-oai-search-svn

Configurations Modification du fichier build.properties

> emacs build.properties Voir le support de formation pour le contenu du fichier

Choisir une configuration du module (config.xml)> cd properties> cp config.example.complet.xml config.xml

Page 41: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 41

TP 4

Éditer config.xml pour pointer vers les modules ori-oai-indexing et ori-oai-vocabulary

> emacs config.xml Voir le support de formation pour le contenu du fichier

Modifier la configuration du plugin openSearch> emacs simple_complet.xml Voir le support de formation pour le contenu du fichier

Déploiement> cd $ORI_HOME/src/ori-oai-search-svn> $ANT_HOME/bin/ant all-servlet

Tests Démarrer le serveur tomcat-search

> cd $ORI_HOME/tomcat-search/bin> sh catalina.sh run

Tester l’URL http://localhost:8184/ori-oai-search

Page 42: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 42

TP 5

Installation de ori-oai-harvester

Page 43: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 43

TP 5

Dépendances des modules Besoin de ori-oai-indexing et de la base eXist

Téléchargement des sources> cd $ORI_HOME> svn checkout http://subversion.cru.fr/ori-oai-harvest/tags/1.0.0

ori-oai-harvester-svn> cd $ORI_HOME/src/ori-oai-harvester-svn

Configurations Modification du fichier build.properties

> emacs build.properties Voir le support de formation pour le contenu du fichier

Copier le fichier ori.example.properties en ori.properties> cd properties> cp ori.example.properties ori.properties

Page 44: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 44

TP 5

Éditer ori.properties pour pointer vers les modules ori-oai-indexing et la base eXist

> emacs ori.properties harvester.* (pour utiliser harvesterConfig.xml et reloadConfig=true, copier/coller le

harvesterConfig.example.xml en harvesterConfig.xml) indexing.* exist.*

Voir le support de formation pour le contenu du fichier

Déploiement> cd $ORI_HOME/src/ori-oai-harvester-svn> $ANT_HOME/bin/ant deploy

Tests Démarrer le serveur tomcat-harvester

> cd $ORI_HOME/tomcat-harvester/bin> sh catalina.sh run

Tester l’URL http://localhost:8181/ori-oai-harvester Moisson

On saisie une définition de moissons et on lance la moisson On vérifie dans l’interface du module ori-oai-search qu’on retrouve bien les fiches

moissonées : URL http://localhost:8184/ori-oai-search

Page 45: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 45

TP 6

Installation de ori-oai-repository

Page 46: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 46

TP 6

Dépendances des modules Besoin de ori-oai-indexing et ori-oai-vocabulary

Téléchargement des sources> cd $ORI_HOME> svn checkout http://subversion.cru.fr/ori-oai-repo/tags/1.0.0

ori-oai-repository-svn> cd $ORI_HOME/src/ori-oai-repository-svn

Configurations Modification du fichier build.properties

> emacs build.properties Voir le support de formation pour le contenu du fichier

Copier le fichier ori-oaicat.example.properties en ori-oaicat.properties> cd properties> cp ori-oaicat.example.properties ori-oaicat.properties

Page 47: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 47

TP 6

Éditer ori-oaicat.properties pour pointer vers les modules ori-oai-indexing et ori-oai-vocabulary, et définir l’identité de l’entrepôt

> emacs ori-oaicat.properties identify.* (information pour définir l’identité de l’entrepôt) indexing.* vocabulary.*

Voir le support de formation pour le contenu du fichier

Modifier properties/repository-crosswalks.xml ->voir support Modifier webapps/WEB-INF/web.xml (le context-param de nom properties) Modifier WebContent/xsl/ihm_main.xsl (nom du contexte) ->voir support

Déploiement> cd $ORI_HOME/src/ori-oai-repository-svn> $ANT_HOME/bin/ant deploy

Tests Démarrer le serveur tomcat-repository

> cd $ORI_HOME/tomcat-repository/bin> sh catalina.sh run

Tester l’URL http://localhost:8180/ori-oai-repository Tester la requête OAI-PMH http://localhost:8180/ori-oai-repository?verb=Identify

Page 48: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 48

TP 7

Installation de ori-oai-md-editor

Page 49: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 49

TP 7

Introduction Besoin des modules vocabulary et workflow

Installation Checkout directement dans le webapps de Tomcat

Configurations Modif du fichier WEB-INF/resources/apps/ori-md-

editor/config.xml On teste l’éditeur non connecté au module de

workflow : édition rapide (et partielle!) d’une fiche LOM

Page 50: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 50

TP 7

Depuis tomcat-editeur/webapps : svn checkout http://subversion.cru.fr/ori-workflow/ori-oai-md-editor/tags/ori-oai-md-editor-1.0.0 ori-oai-md-editor

Depuis ori-oai-md-editor Modif de WEB-INF/resources/apps/ori-md-

editor/config.xml Depuis tomcat-editeur/bin, on lance le tomcat

sh catalina.sh run Depuis http://localhost:8186/ori-oai-md-editor tester un

formulaire …

Page 51: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 51

TP 8

Installation de ori-oai-workflow

Page 52: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 52

TP 8

Introduction Besoin des modules md-editor, indexing

Création de la collection pour ori-oai-workflow Installation

Checkout Configurations

Modif du fichier conf/properties/main-config.properties Modifications permissions/groupes

Déploiement Initialisation de la base de données Tests On teste le workflow, l’éditeur, la publication d’une fiche de

métadonnées.

Page 53: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 53

TP 8

Via http://localhost:8187/exist , lien admin, créer une collection /db/ori/workflow Depuis src :

svn checkout http://subversion.cru.fr/ori-workflow/ori-oai-workflow-spring/tags/ori-oai-workflow-spring-1.0.0 ori-oai-workflow-svn

Depuis ori-oai-workflow-svn Modif de build.properties Modif de conf/properties/main-config.properties

=> pour les groupes ldap, pour groupSearchbase, supprimer ou=groups Modif de conf/properties/spring/acegi/acegi-authentication-additional-groups.xml ant deploy

=> compilation et déploiement ant init

=> initialisation de la base de données ant update-acls

=> mises à jour des permissions/rôles par défaut dans la base de données

Depuis tomcat-workflow/bin, on lance le tomcat sh catalina.sh run

Tester l’interface http://localhost:8185/ori-oai-workflow

Page 54: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 54

Projet ORI-OAI

Solution de stockage des ressources

Page 55: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 55

Solution de stockage ESUP-Portail

Versions V1 non intégration Futur

Intégration en 1.5 Evolution du serveur

Serveur et Canal stockage Copier / coller

Avec canal stockage Sans canal stockage

Page 56: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 56

Projet ORI-OAI

Configuration avancée

Page 57: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 57

Ajout d’une métadonnée

Certains modules ne sont pas configurés avec la métadonnée « semantic density » du LOM [pour infos: non présente dans le LOMFR]

Cette métadonnée peut admettre un certain nbre de valeurs définies par LOM: Very low Low Medium High Very high

But Intégration de cette métadonnée dans les différents modules

Page 58: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 58

TP 9

Ajout d’un vocabulaire dansori-oai-vocabulary

Page 59: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 59

TP 9

Nouveau vocabulaire common_lom_educ_semantic density

Vocabulaire de type « statique » et local au module (spécifique à notre installation ori-oai)

Page 60: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 60

TP 9

Création du nouveau fichier XML de vocabulaire conf/properties/custom_vocabularies/common_lom_educ_semantic density.xml On copie/colle le fichier

conf/properties/ori_vocabularies/common/lom/educ_difficulty.xml pour point de départ

Ajout d’un point d’entrée de déclarations de vocabulaires « custom » dans conf/properties/domain/domain.xml <import resource="customVocabulary.xml" />

Création de customVocabulary.xml (en se basant sur oriVocabularies.xml qui déclare des vocabulaires de type statique). => on définit un nouveau bean de type XmlStaticVocabularyProvider avec

pour id common_lom_educ_semantic_density On déploie (ant deploy) On teste via l’éditeur de métadonnées :

http://NOM_SERVEUR_ORI:8186/ori-oai-md-editor/ori-md-editor/vocab/common_lom_educ_semantic_density

Page 61: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 61

TP 10

Saisie de la nouvelle métadonnée dans ori-oai-md-

editor

Page 62: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 62

TP 10

L’éditeur « auteur » / « Fiche simple » ne donne pas la possibilité d’éditer la métadonnée « seamntic density »

=>on ajoute dans le formulaire la « widget » qui permet l’édition de cette métadonnée en s’appuyant sur le vocabulaire préalablement défini et déclaré.

Les fichiers spécifiques à l’éditeur de métadonnées se trouvent dans le répertoire WEB-INF/resources/apps/ori-md-editor/ Description

Xforms : contient les formulaires XForms Prototypes : contient des fichiers XML contenant tous les blocs XML

possibles xml-blank : … …

=> on va modifier certains d’entres eux.

Page 63: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 63

TP 10

Xforms/lom-author-light/main-form.xhtml « XForms Model »

Instance de vocabulaire common_..._density.xml Xforms/lom-author-light/content-xforms.xml

« XForms Content » Ajout du bloc « semantic densisty » (en prenant exemple sur le bloc

« learning resource type ») I18n/fr_FR.xml / i18n/en_EN.xml

Ajout des balises add/del-semanticDensity Xml-blank/lom-author-light-blank.xml

On ajoute par défaut le bloc semanticDensity dans le XML « d’initialisation ».

Valable pour le mode non connecté au workflow seulement … => tester le formulaire modifié

Page 64: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 64

Ajout d’une métadonnéeEspaces de Noms … !

Pour ajouter une nouvelle métadonnée non LOM, il faut tenir compte des espaces de noms.

Un espace de noms permet dans une fichier XML d’identifier de manière unique les éléments et attributs d’un fichier XML

Ici l’espace de noms associé au LOM est http://ltsc.ieee.org/xsd/LOM, aussi nous avons ajouté la métadonnée « semantic density » dans cet espace de noms.

Si nous voulions prendre en compte une métadonnée spécifique à notre établissement, au LOMFR, etc. nous devrions le faire dans l’espace de noms spécifique à notre établissement, LOMFR, etc.

=> voir en annexe, l’exemple plus poussé de l’ajout d’une métadonnée dans l’éditeur ORI-OAI

Page 65: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 65

TP 11

Obligation de saisie de la nouvelle métadonnée dans ori-oai-workflow

Page 66: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 66

TP 11

On veut rendre obligatoire la saisie de la métadonnée « semantic density »

== on ne veut pas que l’auteur puisse demander la validation de sa fiche si celui-ci n’a pas saisie cette métadonnée

=> on modifie le workflow pour ajouter/modifier une condition sur une transition.

Page 67: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 67

TP 11

Modification de properties/spring/osworkflow/workflows/workflow_easy.xml <arg

name="xpath7">/lom:lom/lom:educational/lom:semanticDensity/lom:value[normalize-space(.) != '']</arg>

On redéploie (ant deploy) le workflow et on redémarre

Page 68: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 68

TP 12

Indexation de la nouvelle métadonnée dans ori-oai-indexing

Page 69: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 69

TP 12

Modification du fichier de configuration de LIUS

3 ajouts à apporter Partie indexation : balise luceneField avec attributs :

xpathSelect, name, et type (Conca tDate,Vcard ou Text)

Partie recherche Partie affichage de résultats

Page 70: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 70

TP 12

ORI_HOME/src/ori-oai-indexing-svn/properties/liusConfig.xml

Ajout de la balise luceneField dans la balise index, à l’intérieur de la partie LOM (5. Pédagogie)

Ajout du xpath encodé dans la balise <multiFieldQueryParser> (Attention à précéder d’une virgule)

Ajout de la balise luceneField dans <fieldsToDisplay>

ant all Redémarrage du Tomcat

Page 71: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 71

TP 13

Recherche dans la nouvelle métadonnée dans ori-oai-search

Page 72: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 72

TP 13

1) Modification de la recherche avancée Ajout d’un champ de recherche pour « semantic density »

modification de la config du formulaire de recherche avancée> cd $ORI_HOME/src/ori-oai-search-svn/properties/advanced> emacs lom_advanced.xml Voir le support de formation pour le contenu du fichier

ajout du libellé du champ dans les fichiers i18n> cd $ORI_HOME/src/ori-oai-search-svn/properties/messages> emacs forms_fr.properties Voir le support de formation pour le contenu du fichier

Page 73: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 73

TP 13

1) Affichage des résultats Ajout de la métadonnée « semantic density » dans la liste des

résultats de recherche

modification de la configuration des résultats> cd $ORI_HOME/src/ori-oai-search-svn/properties> emacs config.xml Voir le support de formation pour le contenu du fichier

ajout du libellé du champ dans les fichiers i18n> cd $ORI_HOME/src/ori-oai-search-svn/properties/messages> emacs menus_fr.properties Voir le support de formation pour le contenu du fichier

Page 74: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 74

TP 13

1) Affichage de « semantic density » dans la notice modification de la XSL de transformation

> cd $ORI_HOME/src/ori-oai-search-svn/webapp/WEB-INF/xsl> emacs lom1.xsl Voir le support de formation pour le contenu du fichier

ajout du libellé du champ dans les fichiers i18n> cd $ORI_HOME/src/ori-oai-search-svn/properties/messages> emacs xsl_fr.properties Voir le support de formation pour le contenu du fichier

ajout du passage de paramètres depuis la JSP> cd $ORI_HOME/src/ori-oai-search-svn/webapp/WEB-INF/stylesheets/notice> emacs notice.jsp Voir le support de formation pour le contenu du fichier

ajout de la traduction de la valeur de la métadonnée> cd $ORI_HOME/src/ori-oai-search-svn/properties> emacs config.xml Voir le support de formation pour le contenu du fichier

Page 75: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 75

TP 13

Déploiement des modifications> cd $ORI_HOME/src/ori-oai-search-svn> $ANT_HOME/bin/ant all-servlet

Tests Arrêter le serveur tomcat-search Démarrer le serveur tomcat-search

> cd $ORI_HOME/tomcat-search/bin> sh catalina.sh run

Tester les changements depuis l’URL http://localhost:8184/ori-oai-search

Page 76: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 76

TP 14

Modification/personnalisation d’un workflow dans ori-oai-workflow

Page 77: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 77

Page 78: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 78

TP 14

But : Modification/Personnalisation d’un workflow Ajout d’un état Ajout d’une transition

Avec actions/conditions sur la transition => Ajout de permissions/rôles Ajout d’un formulaire spécifique à l’état archived Ajout de 2 « catégories »

« ressources publiées » (pour l’archiveur) « mes documents archivés » (pour le propriétaire et

l’archiveur)

Page 79: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Rennes, mars 2008 Formation technique ORI-OAI 79

TP 14

Ajout de la permission et du rôle relatif à l’archivage acegi-permissions.xml

Ajout d’une « action » et d’un « step » osworkflow workflow_very_easy.xml

Ajout de la déclaration d’un formulaire pour OAI_DC spring-metadata-types.xml

Création du formulaire ori-oai-md-editor

Création d’un groupe virtuel Acegi-authentication-additional-groups.xml

Affectation dun rôle à un groupe virtuel Acegi-acls-root.xml

Ajout de 2 Catégories « ressources publiées », « mes documents archivés » Spring-categories.xml Properties/spring/common/i18n/bundles/Custom_*.properties

Page 80: Formation technique ORI-OAI · Rennes, mars 2008 Formation technique ORI-OAI 4 Programme de la formation Organisation 3 jours 26 mars 9h30 28 mars 16h Public Services informatiques

Licence

Copyright © 2008 Consortium ORI-OAI Ce document peut être copié et distribué dans son

intégralité, sans modification, retrait ou ajout. Tout usage commercial est interdit. L’utilisation de ce document dans un cadre de formation

collective est soumise à l’approbation explicite et préalable de ses auteurs.