Installation ORI-OAI V1 sous Linux Mandriva One 2008 Table des matières 1.Introduction...2 2.Prérequis...3 3.Installer Mandriva one 2008...5 4.Installation de Java...6 4.1Déclaration des variables d'environnement...6 5.Installer ANT...7 5.1Déclaration des variables d'environnement...7 6.Installation de TOMCAT...9 7.Installation d'un serveur LDAP...12 8.Installation des modules...19 8.1Installation de la base exist...19 8.2Installation de la base de données MySql...24 8.3Installation du module ori-oai-workflow...25 8.4Installation du module ori-oai-editor...28 8.5Installation du module ori-oai-harvester...29 8.6Installation du module ori-oai-repository...30 8.7Installation du module ori-oai-vocabulary...33 8.8Installation du module ori-oai-indexing...35 8.9Installation du module ori-oai-search...36 9.Lancement des modules ORI...37 10.Tester l'application...47 10.1Moissonner un entrepot...47 10.2Référencer un document...49 10.3Rechercher une fiche de métadonnées...56 10.4Contrôler l'entrepôt OAI...59 11.Conclusion...62 12.Glossaire...62 1/63
1. Introduction Le but de ce tutoriel est d'installer tous les modules d'ori-oai V1 ainsi que tous les composants nécessaires à son utilisation. Vous pourrez ainsi : Utiliser le workflow (module ORI-OAI-WORKFLOW) pour saisir des métadonnées (LOM ou DC), suivre le processus de publication (par défaut, pour les fiches LOM, un workflow simple à 3 étapes est proposé : état privé, demande de publication, publié ; et pour les fiches DC un workflow à 2 étapes : état privé, publié). Vous pourrez définir 3 rôles (Auteur, Modérateur, Administrateur) qui vous permettront de manipuler le workflow dans tous les sens. Moissonner (module ORI-OAI-HARVESTER) des entrepôts OAI. Rechercher (module ORI-OAI-SEARCH) le résultat des moissons ainsi que les métadonnées que vous aurez publiées. Consulter les métadonnées moissonnées et les exposer pour des entrepôts OAI (module ORI-OAI-REPOSITORY). Ce document s'inspire en grande partie des documentations fournies par chaque module, il est fortement recommandé de les consulter avant de commencer afin de paramétrer finement l'application. Vous trouverez la documentation des modules en ligne à l'adresse : http://www.ori-oai.org/install Vous trouverez également à la fin de ce document un aide mémoire des commandes linux utilisées dans ce tutoriel 2/63
2. Prérequis Vous devez connaître un minimum de commandes de base linux pour pouvoir suivre ce tutoriel, un glossaire est disponible à la fin de ce document pour vous aider à utiliser ces commandes. Lorsque vous verrez la mention «en tant que root» dans ce document, vous devrez taper la commande su (mot de passe admin_ori) dans la console afin que les commandes suivantes soient exécutées par l'utilisateur root. Matériel : Pour réaliser ce tutoriel, nous avons utilisé une machine ayant les caractéristiques suivantes: PIV 3Ghz, 2Go de RAM, Disque dur 80Go, Linux Mandriva 2008 one En tant que root, créez les répertoires /usr/local/ori et /usr/local/ori/download («mkdir /usr/local/ori», «mkdir /usr/local/ori/download»). Affectez l'utilisateur ori comme propriétaire du répertoire /usr/local/ori et de ses sous répertoires («cd /usr/local», «chown -R ori:root ori»). Tous les fichiers téléchargés devront être placés dans le répertoire /usr/local/ori/download. Système d'exploitation: Mandriva One 2008 : http://www.mandriva.com/fr téléchargez l'image iso (~ 694Mo) Installation et mise à jour des packages avec URPMI : Ouvrez un navigateur et allez à l'adresse : http://easyurpmi.zarb.org/?language;fr Si les informations qui s'affichent dans le formulaire sont bonnes, cliquez sur passez à l'étape 2, sinon, remplissez le formulaire. A l'étape 2, ne rien toucher, cliquez passer à l'étape 3. A l'étape 3, copiez les commandes comme indiqué sur la page et collez les dans une console (en tant que root). Appuyez sur la touche Entrée pour valider la dernière instruction. Exemple : exécutez les 4 commandes ci dessous (1 commande = 3 lignes) dans une console en tant que root. urpmi.addmedia main ftp://fr2.rpmfind.net/linux/mandrakelinux/official/2008.0/i586/media/main/release with media_info/hdlist.cz urpmi.addmedia --update main_updates ftp://fr2.rpmfind.net/linux/mandrakelinux/official/2008.0/i586/media/main/updates with media_info/hdlist.cz urpmi.addmedia contrib ftp://fr2.rpmfind.net/linux/mandrakelinux/official/2008.0/i586/media/contrib/release with media_info/hdlist.cz urpmi.addmedia --update contrib_updates ftp://fr2.rpmfind.net/linux/mandrakelinux/official/2008.0/i586/media/contrib/updates with media_info/hdlist.cz 3/63
Logiciel : JAVA (JDK 5.0 Update 14, http://java.sun.com/javase/downloads/index_jdk5.jsp, jdk-1_5_0_14-linux-i586-rpm.bin) ANT 1.7 (http://ant.apache.org/bindownload.cgi, apache-ant-1.7.0-bin.tar.gz) TOMCAT 5.5 (http://tomcat.apache.org/download-55.cgi, apache-tomcat-5.5.25.tar.gz) Base exist (http://prdownloads.sourceforge.net/exist/, exist-1.1.1-newcore.war) Base MySql : dans une console en tant que root, tapez urpmi mysql-max (installer les dépendances : oui) En option : Serveur LDAP : dans une console en tant que root, tapez urpmi openldap-servers (installer les dépendances : oui) Schéma SUPANN : supann.schema (http://www.cru.fr/ldap/supann/schema/supann.schema) Enregistrez le fichier avec le nom supann.schema (menu fichier, enregistrez sous du navigateur) Client LDAP ( http://downloads.sourceforge.net/jxplorer/jxv3.2deploy.zip? modtime=1172996748&big_mirror=0, JXv3.2deploy.zip) Téléchargez les 7 modules d'ori-oai-v1 sur le site http://www.ori-oai.org/telechargements.html (A la date du 01/12/2007) ori-oai-repository-1.0.0.zip ori-oai-vocabulary-1.0.0.tgz ori-oai-md-editor-1.0.0.tgz ori-oai-workflow-spring-1.0.0.tgz ori-oai-indexing-1.0.0.zip ori-oai-search-1.0.0.zip ori-oai-harvester-1.0.0.zip Il faut aussi connaître : Le nom de la machine sur laquelle vous installez ORI-OAI (ex : ori.insa-lyon.fr). Nous nommerons cette adresse NOM_SERVEUR_ORI dans ce document. L'adresse du serveur SMTP de l'établissement (ex : smtp.insa-lyon.fr). Nous nommerons cette adresse SMTP_ETABLISSEMENT dans ce document. L'adresse du serveur LDAP de l'établissement (ex : auth.insa-lyon.fr). Le serveur que vous installez doit avoir accès au serveur LDAP. Nous nommerons LDAP_ETABLISSEMENT cette adresse dans ce document. (Ce tutoriel explique également comment installer un serveur LDAP localement si vous n'en avez pas, ce qui vous permettra de créer plusieurs utilisateurs représentant différents rôles dans l'application) Remarque générale :dans ce tutoriel, nous utilisons des mots de passe simples. Lors d'un déploiement en production d'ori-oai, utilisez des mots de passe complexes et en phase avec la politique de mot de passe (si elle existe) mise en place dans votre établissement. 4/63
3. Installer Mandriva one 2008 Insérer le CD Mandriva One 2008 dans le lecteur et suivre les instructions qui s'affichent à l'écran. Vous devez posséder une connexion internet car une partie de l'installation se fait en live. Au cours de l'installation, indiquez les informations ci-dessous pour compléter la configuration : Choisir : Utiliser l'espace disponible Mot de passe root : «admin_ori» Créer un utilisateur : login : «ori» mot de passe : «ori» clic sur avancé : groupe : affecter le groupe root à l'utilisateur ori. A la fin de l'installation, lorsque le serveur est relancé, il faut configurer le réseau. Allez dans le menu Mandriva, Système, Configuration, Configurer votre ordinateur (mot de passe : «admin_ori»). Menu Réseau & Internet, Configurer une nouvelle connexion internet. Choisir Ethernet, cliquez sur Suivant. Cliquez sur Configuration manuelle (renseignez l'adresse IP, masque de sous réseau,...). Cochez Autoriser les utilisateurs à gérer la connexion. Voulez vous démarrer la connexion maintenant : oui. Le réseau est maintenant opérationnel Note : il est important que l'adresse IP attribuée au serveur puisse se connecter à internet 5/63
4. Installation de Java NE PAS INSTALLER LE JAVA FOUNI AVEC MANDRIVA Ouvrez une console en tant que root. Placez vous dans le répertoire download ( cd /usr/local/ori/download ) Changez les droits du fichier jdk-1_5_0_14-linux-i586-rpm.bin ( chmod 755 jdk-1_5_0_14-linux-i586-rpm.bin ) Lancez l'installation de JAVA (./jdk-1_5_0_14-linux-i586-rpm.bin ) Suivez les instructions. 4.1 Déclaration des variables d'environnement En tant que root, éditez le fichier /home/ori/.bash_profile ( vi /home/ori/.bash_profile ) et ajoutez : JAVA_HOME=/usr/java/jdk1.5.0_14 export JAVA_HOME PATH=$PATH:$JAVA_HOME/bin export PATH En tant que root, éditez le fichier /root/.bashrc ( vi /root/.bashrc ) et ajoutez : #.bashrc PATH=/sbin:/usr/sbin:/bin:/usr/bin:/usr/X11R6/bin:/usr/local/bin:/usr/local/sbin ENV=$HOME/.bashrc USERNAME="root" export USERNAME ENV PATH JAVA_HOME=/usr/java/jdk1.5.0_14 export JAVA_HOME PATH=$PATH:$JAVA_HOME/bin export PATH # Source global definitions if [ -f /etc/bashrc ]; then. /etc/bashrc fi Fermez la session et ouvrez une nouvelle connexion en tant qu'utilisateur ori (mot de passe «ori») (afin que les variables d'environnement soient chargées). Lorsque la session est démarrée, ouvrez une fenêtre terminal et tapez : «java -version». Vous devriez avoir l'affichage suivant : 6/63
JAVA est maintenant installé. Si vous n'avez pas cet affichage, vérifiez que les variables sont bien définies, redémarrez le serveur et essayez à nouveau la commande «java -version». 5. Installer ANT NE PAS INSTALLER ANT FOUNI AVEC MANDRIVA En tant que root, placez vous dans le répertoire /usr/local/ori/download ( cd /usr/local/ori/download ) et décompressez le fichier apache-ant-1.7.0-bin.tar.gz ( tar -xvf apache-ant-1.7.0-bin.tar.gz ) Déplacez le répertoire apache-ant-1.7.0 dans /usr/local/ori ( mv apache-ant-1.7.0../ ) 5.1 Déclaration des variables d'environnement En tant que root, éditez le fichier /home/ori/.bash_profile ( vi /home/ori/.bash_profile ) et ajoutez : ANT_HOME=/usr/local/ori/apache-ant-1.7.0 export ANT_HOME PATH=$PATH:$ANT_HOME/bin export PATH 7/63
En tant que root, éditez le fichier /root/.bashrc ( vi /root/.bashrc ) et ajoutez : #.bashrc PATH=/sbin:/usr/sbin:/bin:/usr/bin:/usr/X11R6/bin:/usr/local/bin:/usr/local/sbin ENV=$HOME/.bashrc USERNAME="root" export USERNAME ENV PATH JAVA_HOME=/usr/java/jdk1.5.0_14 export JAVA_HOME PATH=$PATH:$JAVA_HOME/bin export PATH ANT_HOME=/usr/local/ori/apache-ant-1.7.0 export ANT_HOME PATH=$PATH:$ANT_HOME/bin export PATH # Source global definitions if [ -f /etc/bashrc ]; then. /etc/bashrc fi Fermez la session et ouvrez une nouvelle connexion en tant qu'utilisateur ori (mot de passe «ori») (afin que les variables d'environnement soient chargées). Lorsque le session est démarrée, ouvrez une fenêtre terminal et tapez : «ant -version». Vous devriez avoir l'affichage suivant : Si vous ne voyez pas cet affichage, vérifiez que les variables sont bien définies puis redémarrez le serveur et essayez à nouveau la commande «ant -version». 8/63
6. Installation de TOMCAT Nous allons utiliser un serveur Tomcat pour chaque Module ORI-OAI, et également un serveur TOMCAT pour la base exist. En tant que root, allez sans le répertoire /usr/local/ori/download. (cd /usr/local/ori/download ) Décompressez le fichier apache-tomcat-5.5.25.tar.gz ( tar -xvf apache-tomcat-5.5.25.tar.gz ) Ouvrez le fichier tomcat-users.xml (vi /usr/local/ori/download/apache-tomcat-5.5.25/conf/tomcat-users.xml ). Ajoutez l'utilisateur admin : <tomcat-users> <user name="tomcat" password="tomcat" roles="tomcat" /> <user name="role1" password="tomcat" roles="role1" /> <user name="both" password="tomcat" roles="tomcat,role1" /> <user name="admin" password="admin_ori" roles="admin,manager" /> </tomcat-users> Enregistrez le fichier. Ouvrez le fichier catalina.sh ( vi /usr/local/ori/download/apache-tomcat-5.5.25/bin/catalina.sh ) Ajoutez (après la grande section de commentaires) export CATALINA_OPTS="-Dfile.encoding=UTF-8 $CATALINA_OPTS" Enregistrez le fichier. Allez dans le répertoire /usr/local/ori/download ( cd /usr/local/ori/download ) Créez un tomcat pour chaque module et la base exist dans /usr/local/ori cp -R apache-tomcat-5.5.25../tomcat-repository cp -R apache-tomcat-5.5.25../tomcat-harvester cp -R apache-tomcat-5.5.25../tomcat-indexing cp -R apache-tomcat-5.5.25../tomcat-vocabulary cp -R apache-tomcat-5.5.25../tomcat-search cp -R apache-tomcat-5.5.25../tomcat-workflow cp -R apache-tomcat-5.5.25../tomcat-editeur cp -R apache-tomcat-5.5.25../tomcat-exist 9/63
Vous devriez obtenir l'affichage suivant dans le répertoire ori : Voici un résumé des ports qui seront utilisés par les différents modules dans Tomcat La colonne en gras représente les ports qu'il faudra utiliser pour accéder aux différents modules avec un navigateur web. (ex : http://nom_serveur_ori:8185/ori-oai-workflow-spring pour accéder au module orioai-workflow). MODULE / PORT Shutdown Non SSL SSL AJP 1.3 Proxy Repository 8280 8180 8480 8380 8580 Harvester 8281 8181 8481 8381 8581 Indexing 8282 8182 8482 8382 8582 Vocabulary 8283 8183 8483 8383 8583 Search 8284 8184 8484 8384 8584 Workflow 8285 8185 8485 8385 8585 Editeur 8286 8186 8486 8386 8586 exist 8287 8187 8487 8387 8587 Modifiez le fichier server.xml qui se trouve dans chaque répertoire tomcat-xxx/conf en utilisant les ports du tableau ci dessus. 10/63
Par exemple, pour le module ori-oai-repository, modifiez le fichier server.xml comme suit : ( vi /usr/local/ori/tomcat-repository/conf/server.xml ) <Server port="8280" shutdown="shutdown"> <!-- Define a non-ssl HTTP/1.1 Connector on port 8180 --> <Connector port="8180" maxhttpheadersize="8192" maxthreads="150" minsparethreads="25" maxsparethreads="75" enablelookups="false" redirectport="8480" acceptcount="100" connectiontimeout="20000" disableuploadtimeout="true" /> <!-- Define a SSL HTTP/1.1 Connector on port 8480 --> <!-<Connector port="8480" maxhttpheadersize="8192" maxthreads="150" minsparethreads="25" maxsparethreads="75" enablelookups="false" disableuploadtimeout="true" acceptcount="100" scheme="https" secure="true" clientauth="false" sslprotocol="tls" /> --> <!-- Define an AJP 1.3 Connector on port 8380 --> <Connector port="8380" enablelookups="false" redirectport="8480" protocol="ajp/1.3" /> <!-- Define a Proxied HTTP/1.1 Connector on port 8580 --> <!-- See proxy documentation for more information about using this. --> <!-<Connector port="8580" maxthreads="150" minsparethreads="25" maxsparethreads="75" enablelookups="false" acceptcount="100" connectiontimeout="20000" proxyport="80" disableuploadtimeout="true" /> --> Enregistrez le fichier. 11/63
7. Installation d'un serveur LDAP Nous vous proposons d'installer un serveur LDAP qui vous permettra de simuler plusieurs rôles. Vous n'êtes pas obligés de l'installer et il est plutôt recommandé d'utiliser celui de votre établissement pour une utilisation en production. Vous avez normalement déjà effectué l'installation des packages dans les prérequis (urpmi openldap-servers). Si ce n'est pas le cas, exécutez la commande. En tant que root, copiez le schéma supann ( cp /usr/local/ori/download/supann.schema /usr/share/openldap/schema ) Créez un mot de passe pour l'administrateur du serveur LDAP Tapez : «slappasswd» nouveau mot de passe : «admin_ori» confirmer mot de passe : «admin_ori» Vous devriez voir l'affichage : Copiez la ligne qui commence par {SSHA}, vous en aurez besoin à l'étape suivante. Éditez le fichier slapd.conf (vi /etc/openldap/slapd.conf ) Modifiez : include /usr/share/openldap/schema/dhcp.schema include /usr/share/openldap/schema/supann.schema include /usr/share/openldap/schema/cosine.schema... # Provide write access to replicators, and cover access to any other # attributes (default anonymous read access may be undesirable) access to dn.subtree="dc=ori,dc=nom_etablissement,dc=fr" by group="cn=replicator,ou=group,dc=ori,dc=nom_etablissement,dc=fr" by users read by anonymous read... ####################################################################### # database definitions ####################################################################### database suffix bdb "dc=ori,dc=nom_etablissement,dc=fr" 12/63
#suffix rootdn #rootdn "o=my Organization Name,c=US" "cn=manager,dc=ori,dc=nom_etablissement,dc=fr" "cn=manager,o=my Organization Name,c=US" # Cleartext passwords, especially for the rootdn, should # be avoided. See slappasswd(8) and slapd.conf(5) for details. # Use of strong authentication encouraged. # rootpw secret #rootpw {SSHA}+p8SUcYyAK23yPnRe6///QiKhUUM4Iir rootpw collez ici la ligne que vous avez mémorisée et qui commence par {SSHA}... # Replicas running syncrepl as non-rootdn need unrestricted size/time limits: limits group="cn=replicator,ou=group,dc=ori,dc=nom_etablissement,dc=fr" size=unlimited time=unlimited Créez un fichier root.ldif ( vi /usr/local/ori/download/root.ldif ) Copiez y les éléments suivants : dn: dc=ori,dc=nom_etablissement,dc=fr objectclass: top objectclass: dcobject objectclass: organization description: root ori o: ori dc: ori Enregistrez le fichier. 13/63
En tant que root, allez dans le répertoire /usr/local/ori/download ( cd /usr/local/ori/download ) Tapez : «slapadd -f /etc/openldap/slapd.conf -l root.ldif». Créez un fichier groups.ldif ( vi /usr/local/ori/download/groups.ldif ) Copiez y les éléments suivants : dn: ou=groups,dc=ori,dc=nom_etablissement,dc=fr ou: Groups objectclass: top objectclass: organizationalunit description: Groupes pour ORI Enregistrez le fichier. Créez un fichier utilisateurs.ldif ( vi /usr/local/ori/download/utilisateurs.ldif ) Copiez y les éléments suivants : dn: ou=people,dc=ori,dc=nom_etablissement,dc=fr ou: people objectclass: top objectclass: organizationalunit description: Utilisateurs pour ORI Enregistrez le fichier. Nous allons maintenant définir le mot de passe (unique) pour les différents comptes (administrateur, moderateur, auteur). En tant que root, tapez : «slappasswd» dans une console nouveau mot de passe : «ori» confirmer mot de passe : «ori» Copiez la ligne qui commence par {SSHA}, vous en aurez besoin à l'étape suivante. (par exemple pour le mot de passe «ori», la clé peut être : {SSHA}p6Ss0dadFX/Y38eiHnfG+SNrqItKnr4X Créez un fichier administrateur.ldif ( vi /usr/local/ori/download/administrateur.ldif ) Copiez y les éléments suivants : # Entrée 1: uid=administrateur,ou=people,dc=ori,dc=nom_etablissement,dc=fr dn:uid=administrateur,ou=people,dc=ori,dc=nom_etablissement,dc=fr givenname: administrateur mail: administrateur@nom_etablissement.fr uid: administrateur sn: administrateur cn: administrateur displayname: Administrateur supannorganisme: 0000000J supannlisterouge: FALSE objectclass: top objectclass: person objectclass: organizationalperson objectclass: inetorgperson objectclass: supannperson userpassword: collez ici la ligne que vous avez mémorisée et qui commence par {SSHA} Enregistrez le fichier. 14/63
Créez un fichier moderateur.ldif ( vi /usr/local/ori/download/moderateur.ldif ) Copiez y les éléments suivants : # Entrée 1: uid=moderateur,ou=people,dc=ori,dc=nom_etablissement,dc=fr dn:uid=moderateur,ou=people,dc=ori,dc=nom_etablissement,dc=fr givenname: Moderateur mail: moderateur@nom_etablissement.fr uid: moderateur sn: moderateur cn: moderateur displayname: Moderateur supannorganisme: 0000000J supannlisterouge: FALSE objectclass: top objectclass: person objectclass: organizationalperson objectclass: inetorgperson objectclass: supannperson userpassword: collez ici la ligne que vous avez mémorisée et qui commence par {SSHA} Enregistrez le fichier. Créez un fichier auteur.ldif ( vi /usr/local/ori/download/auteur.ldif ) Copiez y les éléments suivants : # Entrée 1: uid=auteur,ou=people,dc=ori,dc=nom_etablissement,dc=fr dn:uid=auteur,ou=people,dc=ori,dc=nom_etablissement,dc=fr givenname: auteur mail: auteur@nom_etablissement.fr uid: auteur sn: auteur cn: auteur displayname: Auteur supannorganisme: 0000000J supannlisterouge: FALSE objectclass: top objectclass: person objectclass: organizationalperson objectclass: inetorgperson objectclass: supannperson userpassword: collez ici la ligne que vous avez mémorisée et qui commence par {SSHA} Enregistrez le fichier. En tant que root, allez dans le répertoire /usr/local/ori/download ( cd /usr/local/ori/download ) Le serveur LDAP doit être arrêté (tapez en tant que root) «/etc/init.d/ldap stop». Tapez : «slapadd -f /etc/openldap/slapd.conf -l groups.ldif». Tapez : «slapadd -f /etc/openldap/slapd.conf -l utilisateurs.ldif». Tapez : «slapadd -f /etc/openldap/slapd.conf -l administrateur.ldif». Tapez : «slapadd -f /etc/openldap/slapd.conf -l moderateur.ldif». Tapez : «slapadd -f /etc/openldap/slapd.conf -l auteur.ldif». Démarrez le serveur LDAP ( /etc/init.d/ldap start ) 15/63
Si vous souhaitez vérifier que les groupes et les utilisateurs ont bien été créés, placez vous dans le répertoire /usr/local/ori/download ( cd /usr/local/ori/download ) et décompresser le fichier Jxv3.2deploy.zip ( unzip Jxv3.2deploy.zip ) Placez vous dans le répertoire /usr/local/ori/download/jxplorer ( cd /usr/local/ori/download/jxplorer ) Changez les droits du fichier jxplorer.sh ( chmod 755 jxplorer.sh ) Lancez le programme (./jxplorer.sh ) Vous devriez voir cet affichage : 16/63
Allez dans le menu Fichier, Se Connecter. Remplissez le formulaire : Le mot de passe est «admin_ori». Vous devriez voir cet affichage : 17/63
Déployez la branche people, vous devriez obtenir l'affichage suivant: Au final, retenez que les utilisateurs créés sont donc les suivants: login : administrateur, mot de passe : ori login : moderateur, mot de passe : ori login : auteur, mot de passe : ori 18/63
8. Installation des modules Décompressez les 7 modules dans le répertoire /usr/local/ori/download ( cd /usr/local/ori/download ) Pour les fichier tar.gz, utilisez la commande «tar -xvf nom_du_module». Pour les fichiers.zip, utilisez la commande «unzip nom_du_module». Renommez ensuite chaque répertoire des modules en supprimant le numéro de version. Par exemple : «mv ori-oai-repository-1.0.0 ori-oai-repository». Vous devriez obtenir la structure suivante : 8.1 Installation de la base exist Placez vous dans le répertoire /usr/local/ori/download ( cd /usr/local/ori/download ) Renommez le fichier exist-1.1.1-newcore.war en exist.war ( mv exist-1.1.1-newcore.war exist.war ) En tant que root, lancez le serveur Tomcat de la base exist ( /usr/local/ori/tomcat-exist/bin/startup.sh ) Ouvrez un navigateur WEB et allez dans le manager ( http://nom_serveur_ori:8187/manager/html ). login : «admin» mot de passe «admin_ori» 19/63
Pour déployer le fichier exist.war indiquez le chemin du fichier /usr/local/ori/download/exist.war dans le champ Select WAR file to upload et cliquez sur Deploy. 20/63
Lorsque le déploiement est terminé, cliquez dans la liste des applications sur /exist 21/63
Cliquez sur admin (menu de gauche partie Administration) Tapez le login par défaut («admin», puis validez, il n'y a pas de mot de passe). 22/63
Cliquez sur Manage users, puis sur New user pour créer un compte. Tapez : User : «ori» Groups : «dba» Password : «ori» Repeat : «ori» Home collection : «/db/ori» Cliquez sur Create Cliquez sur Logout (menu de gauche). Tapez le login : «ori» et le mot de passe «ori». Cliquez sur Envoyer Cliquez sur Browse Collections, puis sur ori. Dans le champ New Collection tapez : «workflow». Puis validez en cliquant sur Create Collection. Ouvrez le fichier conf.xml ( vi /usr/local/ori/tomcat-exist/webapps/exist/web-inf/conf.xml). Recherchez le terme «validation=» mettez «no» à la place de «auto». <indexer casesensitive="yes" index-depth="5" preserve-whitespace-mixed-content="no" stemming="no" suppress-whitespace="both" tokenizer="org.exist.storage.analysis.simpletokenizer" track-term-freq="yes" validation="no"> Enregistrez le fichier. 23/63
Arrêtez puis relancez la base exist ( /usr/local/ori/tomcat-exist/bin/shutdown.sh ) puis relancez la ( /usr/local/ori/tomcat-exist/bin/startup.sh ) La base exist est maintenant paramétrée. 8.2 Installation de la base de données MySql Vous avez normalement déjà effectué l'installation des packages dans les prérequis (urpmi mysqlmax). Si ce n'est pas le cas, exécutez la commande en tant que root. Ouvrez le fichier /etc/my.cnf ( vi /etc/my.cnf ) Ajoutez la variable default-table-type et commentez la ligne skip-networking dans la section [mysqld]: default-table-type=innodb... #skip-networking En tant que root, redémarrez la base MySql ( /etc/init.d/mysqld-max restart ) Mettre un mot de passe à l'utilisateur root : En tant que root, tapez : mysqladmin password "admin_ori" Testez la connexion à la base : tapez : mysql -p (mot de passe admin_ori) Vous devriez avoir l'écran suivant: 24/63
Pour créer la base ori_oai_workflow et l'utilisateur mysql_ori (avec le mot de passe mysql_ori), tapez : CREATE database ori_oai_workflow; (validez) Vous devriez avoir la réponse : Query OK, 1 row affected (0.00 sec) Tapez ensuite : GRANT ALL PRIVILEGES ON ori_oai_workflow.* TO 'mysql_ori'@localhost identified by 'mysql_ori'; (validez) Quittez MySql : tapez : quit La base MySQL est prête. 8.3 Installation du module ori-oai-workflow Remarque : Utilisez toujours le slash «/» et jamais l'antishash «\» (même sous windows) Ouvrez le fichier build.properties ( vi /usr/local/ori/download/ori-oai-workflow-spring/build.properties) et modifiez : deploy.home=/usr/local/ori/tomcat-workflow/webapps/ori-oai-workflow-spring Enregistrez le fichier. Ouvrez le fichier main-config.properties ( vi /usr/local/ori/download/ori-oai-workflow-spring/conf/properties/main-config.properties ). Dans ce fichier, les variables identifier.localapplicationprefix et identifier.urlapplicationprefix doivent être adaptées en fonction de l'établissement. (ex : identifier.localapplicationprefix=insa-lyon-ori-wf-1) (ex: identifier.urlapplicationprefix=http://ori.insa-lyon.fr/uid/) Exemple pour l'adresse du LDAP : ldap.providerurl=ldap://authentification.insa-lyon.fr/dc=insa-lyon,dc=fr ou pour le serveur LDAP installé localement, ldap.providerurl=ldap://localhost/dc=ori,dc=nom_etablissement,dc=fr Modifiez : # exist [spring-dao.xml spring-exist.xml] exist.collectionpath=/db/ori/workflow exist.url=xmldb:exist://nom_serveur_ori:8187/exist/xmlrpc exist.username=ori exist.password=ori # hibernate [dao.xml -> advanced config can be made in hibernate.cfg.xml] hibernate.connection.driver_class=com.mysql.jdbc.driver hibernate.connection.url=jdbc:mysql://localhost/ori_oai_workflow hibernate.connection.username=mysql_ori hibernate.connection.password=mysql_ori #hibernate.properties.dialect=org.hibernate.dialect.mysqldialect # in fact with MySQL, innodb is required - so verify the storage engine of your MySQL DataBase 25/63
hibernate.properties.dialect=org.hibernate.dialect.mysqlinnodbdialect # identifier [spring-services.xml] identifier.localapplicationprefix=mon_etablissement-ori-wf-1 identifier.urlapplicationprefix=http://mon_etablissement.fr/uid/ # ldap [acegi-authentication-ldap.xml see it if you want to connect not anonymously] ldap.providerurl=ldap://ldap_etablissement/dc=xxxx,dc=yyyyyy #ldap.managerdn=cn=admin,dc=www,dc=unit-c,dc=fr #ldap.managerpassword=pass # ldap authentication/groups [acegi-authentication.xml] ldap.people.userdnpattern=uid={0},ou=people ldap.people.peopleretrievefilter=(objectclass=person) ldap.people.peoplesearchbase=ou=people ldap.people.uidattribute=uid ldap.people.mailattribute=mail ldap.group.groupsearchbase=ou=groups ldap.group.groupsearchfilter=(memberuid={0}) ldap.group.groupsearchuseruid=memberuid ldap.group.groupuidsearchfilter=cn={0} ldap.group.groupretrievefilter=(objectclass=posixgroup) ldap.group.grouproleattribute=cn # see acegi-authentication-additional-groups.xml to add "virtual group" via people attributes # authentication -> for cas authentication, you should configure web.xml # moreover users that can log with cas must be in ldap too authentication.casauthenticationenabled=true authentication.ldapauthenticationenabled=true # exceptions [exceptionhandling.xml] exceptions.recipientemail=mail_de_l_administrateur # smtp [smtp.xml] smtp.smtpfromaddress.address= mail_de_l_administrateur smtp.smtpfromaddress.personal=ori smtp.smtpinterceptaddress.address= mail_de_l_administrateur smtp.smtpinterceptaddress.personal=admin smtp.smtpserver.host=smtp_etablissement smtp.smtpserver.port=25 # indexing [spring-webservices-client.xml (in fact you can use more than one indexing service - edit directly spring-webservices-client.xml)] indexing1.namespaceuri=http://nom_serveur_ori:8182/ori-oaiindexing/xfire/indexingservice?wsdl indexing1.lookupserviceonstartup=false vocabulary.wsdldocumenturl=http://nom_serveur_ori:8183/ori-oaivocabulary/xfire/orivocabularyservice?wsdl vocabulary.lookupserviceonstartup=false # md-editor [spring-metadata-types.xml] mdeditor.url=http://nom_serveur_ori:8186/ori-oai-md-editor Enregistrez le fichier. Pour affecter des rôles à des utilisateurs, nous allons mettre les utilisateurs dans des groupes virtuels. Ouvrez le fichier acegi-authentication-additional-groups.xml ( vi /usr/local/ori/download/ori-oai-workflow-spring/conf/properties/spring/acegi/acegiauthentication-additional-groups.xml ) et modifiez : 26/63
Si vous utilisez le serveur LDAP installé localement, <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd"> <beans> <bean name="additionalgroupsfiltersmapping" class="org.springframework.beans.factory.config.mapfactorybean"> <property name="sourcemap"> <map> <entry key="all"> <value>(objectclass=person)</value> </entry> <entry key="moderators"> <value>( (&(objectclass=person) (uid=moderateur))(&(objectclass=person)(uid=gtadmin))(&(objectclass=person) (uid=smagadur))(&(objectclass=person)(uid=vbonamy)))</value> </entry> <entry key="admins"> <value>(&(objectclass=person) (uid=administrateur))</value> </entry> </map> </property> </bean> </beans> Sinon, <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd"> <beans> <bean name="additionalgroupsfiltersmapping" class="org.springframework.beans.factory.config.mapfactorybean"> <property name="sourcemap"> <map> <entry key="all"> <value>(objectclass=person)</value> </entry> <entry key="moderators"> <value>( (&(objectclass=person) (uid=login_moderateur))(&(objectclass=person)(uid=gtadmin))(& (objectclass=person)(uid=smagadur))(&(objectclass=person)(uid=vbonamy)))</value> </entry> <entry key="admins"> <value>(&(objectclass=person) (uid=login_administrateur))</value> </entry> </map> </property> </bean> </beans> Enregistrez le fichier. Les bases MySql, exist ainsi que le serveur LDAP sont normalement déjà démarrés si vous avez suivi le tutoriel depuis le début. Si ce n'est pas le cas: En tant que root, tapez /etc/init.d/mysqld-max restart /usr/local/ori/tomcat-exist/bin/startup.sh /etc/init.d/ldap restart 27/63
Placez vous dans le répertoire /usr/local/ori/download/ori-oai-workflow-spring ( cd /usr/local/ori/download/ori-oai-workflow-spring ) Tapez «ant deploy». Si le déploiement s'est bien terminé, vous devriez avoir le message «build successfull» Ensuite, tapez «ant init». A la question voulez vous initialiser la base SQL, répondez «Y». Tapez «ant update-acls». Note importante : copiez les librairies pluto-1.0.1-rc4.jar et portlet-api-1.0.jar qui se trouvent dans le répertoire /usr/local/ori/download/ori-oai-workflow-spring/utils/lib dans /usr/local/ori/tomcat-workflow/webapps/ori-oai-workflow-spring/web-inf/lib. ( cp /usr/local/ori/download/ori-oai-workflow-spring/utils/lib/pluto-1.0.1-rc4.jar /usr/local/ori/tomcat-workflow/webapps/ori-oai-workflow-spring/web-inf/lib cp /usr/local/ori/download/ori-oai-workflow-spring/utils/lib/portlet-api-1.0.jar /usr/local/ori/tomcat-workflow/webapps/ori-oai-workflow-spring/web-inf/lib ) 8.4 Installation du module ori-oai-editor Copiez le répertoire /usr/local/ori/download/ori-oai-md-editor vers /usr/local/ori/tomcatediteur/webapps/ ( cp -R /usr/local/ori/download/ori-oai-md-editor /usr/local/ori/tomcat-editeur/webapps/ ) Ouvrez le fichier config.xml ( vi /usr/local/ori/tomcat-editeur/webapps/ori-oai-md-editor/web-inf/resources/apps/orimd-editor/config.xml) et modifiez : <ori-oai> <workflow-spring> <location>http://nom_serveur_ori:8185/ori-oai-workflow-spring</location> </workflow-spring> <vocabulary> <location>http://nom_serveur_ori:8183/ori-oai-vocabulary</location> </vocabulary> </ori-oai> Enregistrez le fichier. 28/63
8.5 Installation du module ori-oai-harvester Renommer le fichier /usr/local/ori/download/ori-oai-harvester/ant.sh en ant.old ( mv /usr/local/ori/download/ori-oai-harvester/ant.sh ant.old ) Ouvrez le fichier build.properties ( vi /usr/local/ori/download/ori-oai-harvester/build.properties ) et modifiez : #JDK 1.5 directory java.home=/usr/java/jdk1.5.0_14 #Tomcat directory tomcat.home=/usr/local/ori/tomcat-harvester #Deployment directory deploy.home=/usr/local/ori/tomcat-harvester/webapps #Log Directory (optionnal - default : ${tomcat.home}/logs ) #log.dir=e:/logs #Log mode : prod or debug log.mode=prod Enregistrez le fichier. Dupliquez le fichier ori.example.properties et renommez le ori.properties. ( cp /usr/local/ori/download/ori-oaiharvester/properties/ori.example.properties /usr/local/ori/download/ori-oaiharvester/properties/ori.properties ) Ouvrez ce fichier ( vi /usr/local/ori/download/ori-oai-harvester/properties/ori.properties ) et modifiez : # propertie file for ORI Harvester #harvester global options # set to true each time you want to update database with config file harvester.reloadconfig=true harvester.initconfig=/usr/local/ori/tomcat-harvester/webapps/ori-oai-harvester/web- INF/config/harversterConfig.xml #indexing indexing.ws.wsdldocumenturl=http://nom_serveur_ori:8182/ori-oaiindexing/xfire/indexingservice?wsdl indexing.ws.lookupserviceonstartup=false i set to true ONLY if you want to harvest in spite of unreachable indexing Web Service indexing.ignore.error=false #xml database (must be previously created) exist.url=xmldb:exist://nom_serveur_ori:8187/exist/xmlrpc exist.login=ori exist.password=ori exist.collection=/db/ori # if true, persist deleted OAI records in xml database storage.persistdeleted=true Enregistrez le fichier. 29/63
Placez vous dans le répertoire /usr/local/ori/download/ori-oai-harvester ( cd /usr/local/ori/download/ori-oai-harvester ) Tapez «ant deploy». 8.6 Installation du module ori-oai-repository Ouvrez le fichier build.properties (vi /usr/local/ori/ori-oai-repository/build.properties ) et modifiez : java.home=/usr/java/jdk1.5.0_14 #Tomcat directory tomcat.home=/usr/local/ori/tomcat-repository #Deployment directory deploy.home=/usr/local/ori/tomcat-repository/webapps Enregistrez le fichier. Dupliquez le fichier ori-oaicat.example.properties et renommez le ori-oaicat.properties. ( cp /usr/local/ori/download/ori-oai-repository/properties/orioaicat.example.properties /usr/local/ori/download/ori-oai-repository/properties/orioaicat.properties ) Ouvrez le fichier ( vi /usr/local/ori/download/ori-oai-repository/properties/ori-oaicat.properties ) et modifiez : # ORI-OAI-repository Configuration # classes used for main servlet AbstractCatalog.oaiCatalogClassName=org.orioai.repository.domain.service.ORICatalog AbstractCatalog.recordFactoryClassName=org.orioai.repository.domain.logic.ORIRecordFa ctory AbstractCatalog.secondsToLive=3600 # datestamp granularity #AbstractCatalog.granularity=YYYY-MM-DD AbstractCatalog.granularity=YYYY-MM-DDThh:mm:ssZ # Change to include properties peculiar to your implementation of AbstractCatalog ORICatalog.maxListSize=40 ORICatalog.listSets.maxListSize=300 ORIRecordFactory.repositoryIdentifier=mon_etablissement.ori # Custom Identify response values Identify.repositoryName=ORI MON_ETABLISSEMENT Identify.adminEmail=mailto:mail_de_l_administrateur Identify.earliestDatestamp=2006-12-04T00:00:00Z Identify.deletedRecord=no Identify.description.1=<description><oai-identifier xmlns=\"http://www.openarchives.org/oai/2.0/oai-identifier\" xmlns:xsi=\"http://www.w3.org/2001/xmlschema-instance\" xsi:schemalocation=\"http://www.openarchives.org/oai/2.0/oai-identifier http://www.openarchives.org/oai/2.0/oaiidentifier.xsd\"><scheme>oai</scheme><repositoryidentifier>ori.myuniv.fr</repositoryidentifier><delimiter>:</delimiter><sampleidentifier>oai:ori.myuniv:ori-00000012</sampleidentifier></oai-identifier></description> # main Spring context for servlet Spring.contextFile=oaiHandlerContext.xml # xslt files for crosswalk formats 30/63
xslt.dc2lom=/usr/local/ori/tomcat-repository/webapps/ori-oai-repository/webinf/xslt/lom2dc.xsl # Web service for ori-oai-indexing (repository-ws.xml) indexing.ws.wsdldocumenturl=http://nom_serveur_ori:8182/ori-oaiindexing/xfire/indexingservice?wsdl indexing.ws.lookupserviceonstartup=false # Web service for ori-oai-vocabulary (repository-ws.xml) vocabulary.taxonomyid=unit_taxonomie vocabulary.ws.wsdldocumenturl=http://nom_serveur_ori:8183/ori-oaivocabulary/xfire/orivocabularyservice?wsdl vocabulary.ws.lookupserviceonstartup=false # static MD names (repository-domain.xml) static.mdidentifier=md-ori-oai-id static.mdformat=md-ori-oai-namespace static.mdrepository=md-ori-oai-repository static.mddatestamp=md-ori-oai-datestamp #repository name for workflow records workflow.repositoryname=ori-oai-workflow Enregistrez le fichier. Ouvrez le fichier repository-crosswalks.xml ( vi /usr/local/ori/download/ori-oai-repository/properties/repository-crosswalks.xml ) et modifiez : <bean id="lomtodccrosswalk" class="org.orioai.repository.domain.logic.crosswalk.xsltcrosswalk" init-method="init"> <!-- property name="xsltfile" value="${xslt.dclom}"/ --> <property name="xsltfile" value="/usr/local/ori/tomcatrepository/webapps/ori-oai-repository/web-inf/xslt/lom2dc.xsl"/> <property name="namespaceurl" value="http://www.openarchives.org/oai/2.0/oai_dc/ " /> <property name="schemaurl" value="http://www.openarchives.org/oai/2.0/oai_dc.xsd" /> <property name="inprefix" value="lom" /> <property name="outprefix" value="oai_dc" /> </bean> Enregistrez le fichier Ouvrez la fichier repository-domain.xml ( vi /usr/local/ori/download/ori-oai-repository/properties/repository-domain.xml ) et modifiez : <property name="exposedrepositories"> <list> <!-<value>ori-oai-workflow</value> --> </list> </property> En mettant en commentaire la liste des entrepôts à afficher, tous les entrepôts configurés seront affichés. 31/63
Enregistrez le fichier. 32/63
Ouvrez la fichier web.xml ( vi /usr/local/ori/download/ori-oai-repository/webcontent/web-inf/web.xml ) et modifiez : <context-param> <!-The location of the oaicat.properties file containing datapairs used to initialize the OAI repository software. --> <param-name>properties</param-name> <param-value>/usr/local/ori/download/ori-oai-repository/properties/orioaicat.properties</param-value> </context-param> Enregistrez le fichier. Placez vous dans le répertoire du module /usr/local/ori/download/ori-oai-repository. Tapez «ant deploy». 8.7 Installation du module ori-oai-vocabulary Ouvrez le fichier build.properties (/usr/local/ori/download/ori-oai-vocabulary) et modifiez : deploy.home=/usr/local/ori/tomcat-vocabulary/webapps/ori-oai-vocabulary Enregistrez le fichier. Note : si vous utilisez le serveur LDAP installé localement, ldap.url=ldap://localhost:389 ldap.base= dc=ori,dc=nom_etablissement,dc=fr Ouvrez main-config.properties ( vi /usr/local/ori/download/ori-oai-vocabulary/conf/properties/main-config.properties ) et modifiez : # ldap [ldap.xml] # WARNING: you should modify ldapvocabulary.xml TOO (config vcard) ldap.url=ldap://ldap_etablissement:port_ldap_etablissement #ldap.username=cn=admin,dc=www,dc=unit-c,dc=fr #ldap.password=pass ldap.username= ldap.password= ldap.base=dc=xxx,dc=yyy ldap.people.searchbase=ou=people ldap.people.objectclassvalue=person ldap.people.uid=uid ldap.group.searchbase=ou=groups ldap.group.objectclassvalue=posixgroup ldap.group.uid=cn # exceptions [exceptionhandling.xml] exceptions.recipientemail=mail_de_l_administrateur # smtp [smtp.xml] smtp.smtpfromaddress.address=mail_de_l_administrateur 33/63
smtp.smtpfromaddress.personal=ori smtp.smtpinterceptaddress.address=mail_de_l_administrateur smtp.smtpinterceptaddress.personal=nom Administrateur smtp.smtpserver.host=smtp_etablissement smtp.smtpserver.port=25 # indexing [indexingvocabulary.xml] indexing1.wsdldocumenturl=http://nom_serveur_ori:8182/ori-oaiindexing/xfire/indexingservice?wsdl indexing1.lookupserviceonstartup=false Enregistrez le fichier. Placez vous dans le répertoire «/usr/local/ori/download/ori-oai-vocabulary». Tapez «ant deploy». 34/63
8.8 Installation du module ori-oai-indexing Créez sur le serveur les répertoires : /usr/local/ori/indexes/index /usr/local/ori/indexes/tmp ( mkdir /usr/local/ori/indexes mkdir /usr/local/ori/indexes/index mkdir /usr/local/ori/indexes/tmp ) Ouvrez le fichier build.properties ( vi /usr/local/ori/download/ori-oai-indexing/build.properties ) et modifiez : #Repertoire d'installation de Tomcat tomcat.home = /usr/local/ori/tomcat-indexing #Repertoire de deploiement deploy.home = /usr/local/ori/tomcat-indexing/webapps/ #URL vers Tomcat tomcat.url.deploy = http://nom_serveur_ori:8182 Enregistrez le fichier. Ouvrez le fichier configindexing.xml ( vi /usr/local/ori/download/ori-oai-indexing/properties/configindexing.xml ) et modifier : <!-- Repertoire de index --> <indexdir>/usr/local/ori/indexes/index</indexdir> <!-indexdir>./test_index/copie_de_6_indexcdmunitinptinsaenseeihtmitsanstestok</indexdir-> <!-- Repertoire des fichiers temporaires --> <tmpdir>/usr/local/ori/indexes/tmp</tmpdir> <workflowurl>http://nom_serveur_ori:8185/ori-oai-workflowspring/xfire/oriworkflowservice </workflowurl> <!--harvesterurl>http://cas.enseeiht.fr/ori-oaiharvester2/ws/xfire/harvesterwebservice</harvesterurl--> <!--harvesterurl>http://cas.enseeiht.fr/oriharvester/ws/xfire/harvesterwebservice</harvesterurl--> <harvesterurl>http://nom_serveur_ori:8181/ori-oaiharvester/ws/xfire/harvesterwebservice</harvesterurl> <proxy> <proxyhost></proxyhost> <proxyport></proxyport> </proxy> Note : si votre machine passe par un proxy, vous devez paramétrer proxyhost et proxyport. Enregistrez le fichier. Placez vous dans le répertoire «/usr/local/ori/download/ori-oai-indexing». 35/63
Tapez «ant all». 8.9 Installation du module ori-oai-search Ouvrez le fichier build.properties ( vi /usr/local/ori/download/ori-oai-search/build.properties ) et modifiez : #Répertoire d'installation de Tomcat tomcat.home = /usr/local/ori/tomcat-search #Répertoire de déploiement #deploy.home = C:/esupdev/esupdev-2.5/webapps deploy.home = /usr/local/ori/tomcat-search/webapps #Nom de ditribution de l'application #app.name.deploy=ori-oai-search app.name.deploy=ori-oai-search Enregistrez le fichier. Dupliquez le fichier config.example.complet.xml et renommez le en config.xml ( cp /usr/local/ori/download/ori-oai-search/properties/config.example.complet.xml /usr/local/ori/download/ori-oai-search/properties/config.xml ) Ouvez ce fichier et modifiez : ( vi /usr/local/ori/download/ori-oai-search/properties/config.xml ) <?xml version="1.0" encoding="iso-8859-1"?> <!-* ORI-OAI-search - Copyright (c) 2007 ORI-OAI * For any information please refer to http://www.ori-oai.org * You may obtain a copy of the licence at http://www.ori-oai.org/license/ --> <config> <index_search_url>http://nom_serveur_ori:8182/ori-oaiindexing/xfire/indexingservice</index_search_url> <vocabulary_url>http://nom_serveur_ori:8183/ori-oaivocabulary/xfire/orivocabularyservice</vocabulary_url> <default_docs_per_page>10</default_docs_per_page> <max_docs_per_page>40</max_docs_per_page> Enregistrez le fichier. Paramétrage du plugin Open Search pour IE7 et Firefox 2.0 (recherche intégrée au navigateur) Ouvrez les fichiers simplecdm.xml, simple_complet.xml, simple_dc.xml et simple_lom.xml (/usr/local/ori/download/search/webapp/opensearch) et modifiez : <Url type="text/html" template="http://nom_serveur_ori:8184/ori-oai-search/... <moz:searchform>http://nom_serveur_ori:8184</moz:searchform> Enregistrez le fichier. 36/63
Placez vous dans le répertoire «/usr/local/ori/download/ori-oai-search». Tapez «ant all-servlet». 9. Lancement des modules ORI Les bases exist, MySql et le serveur LDAP sont normalement déjà lancés. Si ce n'est pas le cas, lancez : /etc/init.d/mysqld-max restart /etc/init.d/ldap restart /usr/local/ori/tomcat-exist/bin/startup.sh Lancez : /usr/local/ori/tomcat-workflow/bin/startup.sh /usr/local/ori/tomcat-editeur/bin/startup.sh /usr/local/ori/tomcat-harvester/bin/startup.sh /usr/local/ori/tomcat-repository/bin/startup.sh /usr/local/ori/tomcat-vocabulary/bin/startup.sh /usr/local/ori/tomcat-indexing/bin/startup.sh /usr/local/ori/tomcat-search/bin/startup.sh Si tous les modules sont bien lancés, vous pouvez passer au chapitre suivant «TESTER L'APPLICATION». Les logs de chaque module sont disponibles dans les répertoires tomcat-xxx/logs/yyy. Ces informations sont très importantes et permettent en général de retrouver la source d'un problème. En cas de problème, vous pouvez tester les modules de la manière suivante : Test du module ori-oai-indexing Pour tester le module ori-oai-indexing, ouvrez un navigateur et tapez l'url : «http://nom_serveur_ori:8182/ori-oai-indexing/xfire/indexingservice?wsdl». 37/63
Vous devriez obtenir l'affichage suivant : 38/63
Test du module ori-oai-vocabulary Pour tester le module ori-oai-vocabulary, ouvrez un navigateur et tapez l'url : «http://nom_serveur_ori:8183/ori-oai-vocabulary/xfire/orivocabularyservice?wsdl» Vous devriez obtenir l'affichage suivant : Test du module ori-oai-indexing Placez vous dans le répertoire «/usr/local/ori/download/indexing». Tapez «ant testindex». 39/63
Si l'indexation s'est bien passée, vous devriez avoir : Test de la recherche dans l'index Placez vous dans le répertoire «/usr/local/ori/download/ori-oai-indexing». Pour tester la recherche dans l'index tapez «ant testsearch». Si les données ont bien été retrouvées, vous devriez avoir : Supprimez le dossier index (/usr/local/ori/indexes) pour supprimer cet index de test. 40/63
Test du module ori-oai-workflow Pour tester le module ori-oai-workflow, ouvrez un navigateur et tapez l'url : «http://nom_serveur_ori:8185/ori-oai-workflow-spring/xfire/oriworkflowservice? WSDL». Vous devriez obtenir l'affichage suivant : Test du module ori-oai-search Pour tester le module ori-oai-search indépendamment des autres modules suivre cette procédure (extraite de la documentation générale du module) : Une configuration pour tester le module seul Dans le cas d'un premier déploiement, il est prévu de pouvoir tester le module de recherche indépendamment des autres modules. En effet, ceci permet de vérifier que l'application est bien configurée et bien déployée sans dépendre des autres entités du système. Cette manipulation fait que tous les vocabulaires et résultats de recherches sont statiques et avec des libellés sous forme de tests. Pour faire cette manipulation, il faut changer une configuration des beans Spring. Cette configuration concerne les classes utilisées pour la connexion au module ORI-OAI-vocabulary et celle pour la recherche à partir de ORI-OAI-indexing. Vous devez donc à la place utiliser des classes "Mock" c'est-à-dire des classes qui simuleront les connexions aux autres modules. Editez le fichier webapp/web-inf/search-servlet.xml ou webapp/web-inf/searchportlet.xml que vous soyez en déploiement servlet ou portlet. 41/63
Recherchez l'occurence du terme id="vocabulary-service". Vous trouvez alors la configuration du bean Spring désiré. Il suffit de commenter la configuration du bean correspondant à l'implémentation et de dé-commenter celui appelant la classe de test comme suit : <!-- ******************************************************* --> <!-- implémentation de la couche service pour le vocabulaire --> <!-- Implementation --> <!--bean id="vocabulary-service" class="org.orioai.search.vocabulary.service.vocabularyserviceimpl"> <property name="configurationservice"> <ref local="configuration-service"/> </property> <property name="orioaivocabularyservice"> <ref local="ori-oai-vocabulary-service"/> </property> </bean--> <!-- Classe de test --> <bean id="vocabulary-service" class="org.orioai.search.vocabulary.service.mockvocabularyserviceimpl"> </bean> <!-- ******************************************************* --> Ensuite, vous devez faire la même chose pour le bean servant à la recherche en cherchant l'occurance du terme id="search-service" comme suit : <!-- ******************************************************* --> <!-- implémentation de la couche service pour la recherche dans le moteur de recherche --> <!-- Implementation --> <bean id="search-service" class="org.orioai.search.indexer.search.service.lucenesearchserviceimpl"> <property name="configurationservice"> <ref local="configuration-service"/> </property> </bean> <!-- Classe de test --> <!--bean id="search-service" class="org.orioai.search.indexer.search.service.mocksearchserviceimpl"> <property name="configurationservice"> <ref local="configuration-service"/> </property> </bean--> <!-- ******************************************************* --> Placez vous dans le répertoire «/usr/local/ori/download/search». Tapez «ant all-servlet». Ouvrir un navigateur à l'adresse : http://nom_serveur_ori:8184/ori-oai-search Cliquez sur l'onglet Nouveautés 42/63
Test du module ori-oai-workflow-spring Pour tester la connexion au module ori-oai-vocabulary, à la base exist, Mysql,... Placez vous dans le répertoire «/usr/local/ori/download/ori-oai-workflow-spring». Tapez «ant remoteconfigtest». 43/63
Vous devriez obtenir l'affichage suivant: Test de l'éditeur de métadonnées Ouvrez un navigateur à l'adresse : «http://nom_serveur_ori:8186/ori-oai-md-editor/orimd-editor/lom-full/blank» 44/63
Test du module ori-oai-harvester Pour tester le module ori-oai-harvester, ouvrez un navigateur et tapez l'url : «http://nom_serveur_ori:8181/ori-oai-harvester/ws/xfire/harvesterwebservice?wsdl». 45/63
Vous devriez obtenir l'affichage suivant : 46/63
10. Tester l'application 10.1 Moissonner un entrepot Ouvrez un navigateur web et allez à l'adresse : «http://nom_serveur_ori:8181/ori-oaiharvester». Cliquez sur «+» pour ajouter la définition d'une nouvelle moisson. Dans la partie basse du formulaire, choisissez un entrepôt à moissonner dans la liste déroulante ou tapez directement son url dans le champ en dessous. Cliquez sur «+» pour l'ajouter. Vous devriez obtenir l'affichage suivant : 47/63
Remplissez : le champ identifiant (qui correspond à l'étiquette que vous souhaitez donner à cette moisson) Choisissez moisson différée le champ collection (qui correspond à l'emplacement du stockage dans la base exist, par exemple : dc/insa) choisissez dans la liste déroulante «ensemble» une valeur (si un ensemble a été défini dans l'entrepôt à moissonner) 48/63
Cliquez sur enregistrer cette définition, vous devriez obtenir l'affichage suivant : Cliquez sur le bouton (rond) vert pour lancer la moisson. Cliquez sur «Récoltes» puis sur «Rafraîchir». La moisson peut durer d'une à plusieurs minutes. Appuyez sur rafraîchir à intervalle régulier et lorsque le compteur «nombre de documents» ne s'incrémente plus, la moisson est terminée. Vous pouvez configurer plus finement le moissonneur en vous reportant à la documentation générale du module (c:\source\ori-oai-harvester-0.7.0\docs\docbook\pages\htmlgen\ori-oaiharvester\index.html). 10.2 Référencer un document Ouvrez un navigateur web et allez à l'adresse : «http://nom_serveur_ori:8185/ori-oaiworkflow-spring» Le workflow proposé par défaut pour les fiches LOM comporte trois états : privé, en attente de publication, publié. 49/63
Identifiez vous avec un login ayant le rôle auteur. (login : auteur, mot de passe : ori) Cliquez sur «Accueil». Dans la partie «Référencer une Ressource», choisissez le type de métadonnées que vous souhaitez créer (par exemple «Ressource Pédagogique [LOM]»). Votre aurez peut être une alerte indiquant que le navigateur a refusé d'ouvrir une fenêtre. Sous Firefox : Firefox a empêché ce site d'ouvrir une fenêtre popup Cliquez sur Options (dans le petit bandeau jaune), puis sur Autoriser les popup pour NOM_SERVEUR_ORI 50/63
51/63
Remplissez le formulaire, lorsque celui ci est rempli et validé (le message d'erreur en haut du formulaire a disparu), cliquez sur «Sauvegarder». Les champs obligatoires sont en rose. 52/63
Vous pourrez revenir sur ce formulaire ultérieurement si vous le souhaitez. 53/63
Pour Demander la publication des métadonnées que vous avez saisies, cliquez sur Mes ressources en cours d'édition [1]. Le document est dans l'état «privé». 54/63
Pour passer à l'état «en attente de publication», cliquez sur «demander à publier». Vous pouvez rédiger une observation, puis cliquez sur «ok». Déconnectez vous de l'utilisateur ayant le rôle Auteur (clic sur Bienvenue, puis Quitter) et connectez vous avec un utilisateur ayant le rôle Modérateur (login : moderateur, mot de passe : ori). Pour publier le document, cliquez sur «Accueil» puis sur «Ressources que je dois modérer [1]». 55/63
Cliquez sur «Publier», vous pouvez rédiger une observation, puis cliquez sur «ok». Vos données sont maintenant publiées. 10.3 Rechercher une fiche de métadonnées Note : attendez une minute avant de lancer une recherche après avoir publié vos métadonnées afin que l'indexation des données se termine. Ouvrez un navigateur web et allez à l'adresse : «http://nom_serveur_ori:8184/ori-oaisearch». 56/63
Cliquez sur l'onglet Pédagogie, puis Recherche Simple, cherchez php, Vous devriez voir : 57/63
Cliquez sur Voir la fiche pour afficher les métadonnées. Cliquez sur l'onglet Documents, Nouveautés, vous devriez voir: 58/63
En survolant avec la souris Voir le résumé, vous devriez voir : 10.4 Contrôler l'entrepôt OAI Ouvrez un navigateur web et allez à l'adresse : «http://nom_serveur_ori:8180/ori-oairepository». 59/63
Cliquez sur Identité entrepôt, puis Tous afin de voir toutes les fiches. 60/63
Cliquez sur un identifiant pour voir la fiche correspondante : 61/63
11. Conclusion Vous avez maintenant configuré un ORI-OAI V1 avec succès. Les modules ORI-OAI comportent de nombreux paramétrages qui vous permettront d'adapter les modules à vos besoins. Vous trouverez toute la documentation nécessaire pour configurer des différents modules à l'adresse:http://www.ori-oai.org/install 12. Glossaire Les commandes utilisées dans la console : su permet de se connecter comme super utilisateur (compte qui a tous les droits sur les fichiers et répertoires) cp [option] «fichier ou répertoire source» «fichier ou répertoire destination» exemple : cp -R /usr/local/ori/download/ori-oai-md-editor /usr/local/ori/tomcat-editeur/webapps (le -R sert à copier le contenu de tous les répertoires contenus dans le répertoire source) 62/63
mv «fichier ou répertoire source» «fichier ou répertoire destination» renomme un fichier ou répertoire vi editeur de fichier sous linux exemple : vi /root/.bashrc une fois dans l'éditeur, il faut connaître quelques commandes pour pouvoir l'utiliser, vous trouverez de nombreuses pages d'aide sur internet. 63/63