Manuel d`installation
Contents
1. R autoris en lecture W autoris en criture NO R interdit en lecture NO W interdit en criture Au sein de ce fichier on peut cr er des profil et des user Un exemple de profil lt profil name relecteur gt lt pass type R gt lt path gt Product lt path gt lt path gt Product descendant x lt path gt lt pass gt lt pass type W gt lt path gt Product Title TitleText lt path gt lt path gt Product OtherText lt path gt lt pass gt lt profil gt Davy DERMILLY 05 octobre 2006 4 Onix manager Un exemple de user lt user login dupont password 123 lastname DUPONT firstname Ge Dex 2 function relecteur websiteManagement false gt lt profilName gt relecteur lt profilName gt lt pass type W gt lt path gt Product Subject lt path gt lt pass gt lt pass type NO W gt lt path gt Product Subject SubjectSchemeIdentifier lt path gt lt pass gt lt pass type NO R gt lt path gt Product Contributor lt path gt lt pass gt lt user gt Explications Ici George DUPONT est un relecteur qui ne peut pas mettre jour le site Internet distant websiteManagement false via service web SPIP etc Il r cup re tous les droits du profil relecteur lt profilName gt relecteur lt profilName gt C est dire qu il peut lir2. CodeNotes gt lt IssueNumber gt 0 lt IssueNumber gt lt Code gt lt d but suppression lt Code gt lt CodeNumber gt 5 lt CodeNumber gt lt CodeValue gt 05 lt CodeValue gt lt CodeDescription gt ISMN lt CodeDescription gt lt CodeNotes gt International Standard Music Number lt CodeNotes gt lt IssueNumber gt 0 lt IssueNumber gt lt Code gt fin suppression gt lt Code gt lt CodeNumber gt 9 lt CodeNumber gt lt CodeValue gt 15 lt CodeValue gt lt CodeDescription gt ISBN 13 lt CodeDescription gt lt CodeNotes gt International Standard Book Number lt CodeNotes gt lt IssueNumber gt 4 lt IssueNumber gt lt Code gt lt CodeList gt Il est possible de modifier le champ CodeDescription qui figurera dans les listes d roulantes Attention ne pas modifier le champ Code Value pour rester dans la norme ONIX Davy DERMILLY _ 05 octobre 2006 8 Chapitre 2 Service web d di spip cot serveur 2 1 Configuration requise PHP5 install MYSQLA install SPIP install OnixSpipWS gz 2 2 Installation D compacter l archive OnixSpip WS gz et placer les fichiers dans le dossier www du serveur web Apache Davy DERMILLY 05 octobre 2006 9 Service web d di spip cot serveur 2 3 Configuration du service web Ouvrir le fichier OnixSpipWSConstants php et renseigner les diff rentes constantes define SERVE
3. WEB INF lib et les mettres dans le dossier WEB INF lib de l axis existant 3 modifier le fichier onixcatalogws properties 4 modifier le fichier droi ts xml 4 3 Configuration du service web 4 3 1 Le fichier onixcatalogws properties Le fichier onixcatalogws properties se trouve dans le r pertoire WEB INF classes d axis z Url tomcat serveur url localhost 8080 Nom de la collection principale qui contient votre catalogue exist onixCollection bassinOnix Login et mot de passe dans eXist pour acceder la collection bassinOnix application login admin application password mdp Nombre maximal d enregistrements renvoy s par les recherches afin de ne pas saturer le serveur searchResult maxNumberOfRecord 20 Emplacement du fichier xml droits xml contenant le profil public user file path du fichier droits xml login et mot de l utilisateur qui poss de un profil public dans le fichier droits xml d taill par la suite user login catalogws user password mdp 4 3 2 Le fichier droits xml Il est possible de nommer ce fichier autrement Il faut dans ce cas modifier le fichier onixcatalogws properties en cons quences Ce fichier doit avoir la structure suivante Davy DERMILLY _ 05 octobre 2006 13 Service web r pondant au moteur de recherche lt users gt lt profil name public gt lt pass type R gt lt path gt Pro
4. lt profilName gt renvoie ici au profil public 4 3 3 Pour finir Pour finir red marrer Tomcat pour qu il prenne en compte les modifications Davy DERMILLY 05 octobre 2006 14
5. de passe de l application pour qu elle puisse utiliser le web service d di SPIP correspond ceux du fichier OnixSpipWSConstants php onixSpip WSServer login davy onixSpip WSServer password 123 Davy DERMILLY 05 octobre 2006 11 Chapitre 4 Service web r pondant au moteur de recherche 4 1 Configuration requise jre 1_5_0_10 linux i586 bin install exist 1 0rc war install apache tomcat 5 5 17 install axis gz 4 2 Installation l installation de ce service web passe par diff tentes tapes 4 2 1 Cas o axis n est pas install 1 d compacter l archive axis gz et placer le dossier obtenu dans le r pertoire webApps de Tomcat 2 modifier le fichier onixcatalogws properties 3 modifier le fichier droits xml 4 2 2 Cas o axis est d j install Apr s avoir d compact l archive axis gz 1 R cup rer le dossier axis d compact WEB INF classes onixcatalogws et le fichier azis d compact WEB INF classes onixcatalogws properties et les mettre dans le dossier WEB INF classes de l axis existant 2 R cup rer les fichiers exist jar onix exist tools jar onix kernel jar onix ws search engine jar xml db jar xmluser manager jar Davy DERMILLY 05 octobre 2006 12 Service web r pondant au moteur de recherche xml utils jar xmldb jar xmlrpc 1 2 patched jar qui se trouvent dans le dossier azis d compact
6. principale dans eXist o est rang le catalogue collection bassinOnix Nombre maximal d enregistrements renvoy par chaque recherche searchResult numberOfRecord 15 Num ro du dernier enregistrement ajout la base doit se terminer par un chiffre pour l auto incr mentation product lastRecordReference p1 sur le site de editeur org Davy DERMILLY _ 05 octobre 2006 2 Onix manager Fichiers de configuration de l application Onix manager fournit les fichiers de configurations suivants droits xml productForPass xml defaultProduct xml codeList xml Ils sont pr sents dans le r pertoire WEB INF d onix manager Il va falloir renseigner leur emplacement dans le fichier conf properties Emplacement du fichier des droits et des profils utilisateurs userFile xml uri votre tomcat webapps onix manager WEB INF droits xml Emplacement du fichier qui contient le produit de r f rence avec tous les champs utilis s par l application productForPass xml uri votre tomcat webapps onix manager WEB INF productForPass xml Emplacement du fichier d un produit par d faut il s agit d un produit pr alablement renseign qui appara tra tel quel lors de l ajout d un nouveau produit defaultProduct xml uri votre tomcat webapps onix manager WEB INF defaultProduct xml Emplacement du fichier des listes de codes ONIX codeList xml uri votre tomcat webapps onix manager WEB IN
7. F codeList xml Pour l upload des images Le chemin du r pertoire ou sont stock es les images des diff rents produits pictures directory location votre repertoire Url laquelle ces images seront visualisables avec un navigateur Internet pictures directory url http votre repertoire Il faut bien s re que ce r pertoire ait t pr alablement cr Attention aux droits en criture sur ce r pertoire si on est sous Linux Davy DERMILLY 05 octobre 2006 Onix manager 1 3 2 Le fichier log4j properties Le fichier log4j properties se trouve dans le r pertoire WEB INF Classes d onix manager Dans ce fichier il faut juste renseigner la ligne suivante second Any configuration information needed for that appender log4j appender rolling File logs onix manager log Mettre cet endroit le chemin du fichier log de l application cr er un fichier log vide s il n existe pas C est dans ce fichier que figureront les erreurs si l application ne fonctionne pas 1 3 3 Le fichier ApplicationRessources properties Dans ce fichier sont stock s les diff rents titres et labels de l application Par exemple si l on veut une interface en anglais il faut diter ce fichier et renseigner tous les champs en anglais 1 3 4 Les fichiers de configuration xml droits xml C est ici que sont d finis les droits des utilisateurs Il existe quatre sortes de droits
8. PRESSES UNIVERSITAIRES DAVY DE CAEN DERMILLY Maison de la Recherche en p Sciences Humaines MRSH Ann e 05 06 14032 Caen cedex ONIX MANAGER Manuel d installation d onix manager Table des mati res 1 Onix manager 1 1 1 Configuration requise 1 1 Installation e eneren e iie eiie he re Ls dass aa 1 1 2 1 Variables d environnement 1 122 Installer eXist gt isa su bacca Pos NCAA is dde 1 1 2 3 Installer onix manager oaoa ee Ov ere GE 2 13 Configuration a ee aet e a s D dea e Ant GU a E T GI 8 241 2 1 3 1 Le fichier conf properties 2 1 3 2 Le fichier log4j properties 4 1 3 3 Le fichier ApplicationRessources properties 4 1 3 4 Les fichiers de configuration XML 4 2 Service web d di spip cot serveur 9 21 Configurationrequise 0 0 0 040 0u0u0 0 9 2 2 Installation lt 42 x gt NOG e ee SAD dat Me a ANR G dee SANS Che MO 20 9 2 3 Configuration du service web 10 3 Service web d di spip cot client 11 3 1 Configuration requise 2 a 0 aa NA DEN DL NE L 11 3 2 Configuration du service web 4 SSL 4 RSR LA LE Le ns 11 4 Service web r pondant au moteur de recherche 12 4 1 Configuration requise 24 ue Mt An pe AL OR RE 12 4 2 Tostallation z 5 eve x 2 ee Sa Na pe N a A 12 4 2 1 Cas o axis n est pas install 12 4 2 2 Cas
9. UR localhost nom du serveur MySQL define DB_USER root login pour la base SPIP one PASSWORD mldacm mdp correspondant au login define DB spip Nom de la base spip define SPIP _TABLES_PREFIX spip spip par d faut e Lorsque l on saisi un nouvel article dans SPIP on peut le consulter via une URL qui se termine par le num ro de l article Il faut mettre ci dessous cette URL sans le num ro define URL_ARTICLE http localhost spip spip php article Num ro de rubrique dans laquelle figure le catalogue define CATALOGUEID RUBRIQUE 2 entrer ici le login et mdp de l utilisateur de ce service web define LOGIN davy define PASSWORD 123 Pour les tests lancer index php qui interroge le service Web Davy DERMILLY _ 05 octobre 2006 10 Chapitre 3 Service web d di spip cot client 3 1 Configuration requise onix manager war install 3 2 Configuration du service web Dans le fichier conf properties d onix manager il faut renseigner les lignes suivantes WEB SERVICE MISE A JOUR DU SITE INTERNET x Si l application utilise le web service d di SPIP ou non onixSpip WSServer used false mettre true URL du fichier OnixSpipWSServer php dans le dossier OnixSpipWsS dans le dossier www de votre serveur Apache onixSpip WSServer url http localhost webService OnixSpipWSServer php Login et mot
10. duct RecordReference lt path gt lt path gt Product NotificationType lt path gt lt path gt Product ProductIdentifier ProductIDType 02 lt path gt lt path gt Product ProductForm lt path gt lt path gt Product Title lt path gt lt path gt Product Website lt path gt lt path gt Product Contributor lt path gt lt path gt Product NumberOfPages lt path gt lt path gt Product Subject lt path gt lt path gt Product OtherText lt path gt lt path gt Product MediaFile lt path gt lt path gt Product Imprint lt path gt lt path gt Product Publisher lt path gt lt path gt Product PublicationDate lt path gt lt path gt Product SupplyDetail Price lt path gt lt pass gt lt profil gt lt user login catalogws password mdp lastname SERVICE firstname Web function service web websiteManagement false gt lt profilName gt public lt profilName gt lt user gt lt users gt Explications Le profil public est constitu d un l ment lt pass gt de type R signifiant qu il poss de des droits en lecture sur tous les l ments lt path gt qu il contient Il nous est ainsi permis de d cider quels champs ONIX seront d livr s par le web service lors de son interrogation distante L l ment lt user gt correspond au nom d utilisateur du service web Les user login et user password du fichier onixcatalogws properties L l ment
11. e tout ce qu il y dans un Product et ses enfants et qu il ne peut modifier que les textes de titre Product Title Title Text et les r sum s Product Other Text On peut tout de m me lui ajouter des droits en dehors de son profil Ce qui veut dire que dans l exemple ci dessus George DUPONT peut galement modifier les sujets Product Subject en W sauf les types de sujet Product Sub ject SubjectSchemeldentifier en NO W et qu il ne peut pas voir les auteurs Product Contributor en NO R Davy DERMILLY _ 05 octobre 2006 5 Onix manager On peut ainsi cr er divers profils et un utilisateur peut en h riter de plu sieurs En effet monsieur DUPONT peut avoir de nouvelles fonctions comme par exemple la gestion de stock Ce qui donnerait lt profil name relecteur gt lt pass type R gt lt path gt Product lt path gt lt path gt Product descendant lt path gt lt pass gt lt pass type WWV gt lt path gt Product Title TitleText lt path gt lt path gt Product OtherText lt path gt lt pass gt lt profil gt lt Ajouter un profil gestion stock lt profil name gestion stock gt lt pass type R gt lt path gt Product SupplyDetail Stock lt path gt lt pass gt lt pass type W gt lt path gt Product SupplyDetail Stock lt path gt lt pass gt lt profil gt gt lt user login dupont pas
12. ger ce champ sera pr rempli en fonction de ce qu onix manager trouvera dans le fichier product ForPass xml Dans notre exemple on aura Valeur premier ID Attention ce que les codes 027 037 AB etc soient en accords avec la liste des codes de la DTD ONIX defaultProduct xml Ce fichier est bas sur le m me principe que le pr c dent le caract re sensible en moins Il contient juste un produit par d faut avec certains champs pr renseign s Ainsi lorsqu on ajoute un nouveau produit avec onix manager celui ci est d j renseign avec des valeurs par d faut ce sont en g n rales des valeurs communes chaque produit Davy DERMILLY _ 05 octobre 2006 7 Onix manager codeList xml Ce fichier nous est fournit par ONIX et contient toutes les listes de codes ONIX n cessaires aux listes d roulantes que propose onix manager lors de la modification d un produit On peut par exemple retirer d une liste de type d identifiants de produit les codes d identifiants que l on utilise pas N lt CodeList gt lt CodeListNumber gt 5 lt CodeListNumber gt lt CodeListDescription gt Code type identifiant produit lt CodeListDescription gt lt IssueNumber gt 0 lt IssueNumber gt lt Code gt lt CodeNumber gt 3 lt CodeNumber gt lt CodeValue gt 03 lt CodeValue gt lt CodeDescription gt EAN UCC 13 lt CodeDescription gt lt CodeNotes gt EAN UCC Article Number 13 positions lt
13. in dans la configuration d onix manager Dans le menu Browse Collections cr er une nouvelle collection qui contiendra le catalogue principal exemple bassinOnix Entrer dans cette collection et ajouter autant de catalogues et cat gories que souhait Les garnir en y incluant des fichiers XML au format ONIX histoire g ographie politique Davy DERMILLY 05 octobre 2006 1 Onix manager Attention il y a un probl me avec la gestion de la DTD distante dans eXist Il faut soit supprimer le DOCTYPE du fichier int grer ou bien r cup rer la DTD ONIX et la mettre en local Pour le nommage des collections il est pr f rable de proc der comme suit Nom de la collection Les espaces sont remplac s par des tirets et les caract res ne sont pas accen tu s 1 2 3 Installer onix manager Pour installer onix manager il suffit de mettre onix manager war dans le r pertoire webApps de Tomcat qui se chargera de d ployer l application auto matiquement 1 3 Configuration 1 3 1 Le fichier conf properties Le fichier conf properties se trouve dans le r pertoire WEB INF classes d onix manager param tres pour eXist Url du serveur qui h berge exist serveur url localhost 8080 Identifiant de connexion la base exist nom de l utilisateur cr pour qu onix manager se connecte eXist application login admin application password mdp Nom de la collection
14. o axis est d j install 12 4 3 Configuration du service MODS este a Lente Een lt Len 13 4 3 1 Le fichier onixcatalogws properties 13 4 32 Le fichier droits xml 2 agent a pig x 13 d 33 ROUT DNIE EE Ci EE ME EL ue 14 Davy DERMILLY 05 octobre 2006 i Chapitre 1 Onix manager 1 1 Configuration requise jre 1_5_0_10 linux i586 bin http java sun com javase downloads index_jdk5 jsp exist 1 0rc war http exist sourceforge net index html download apache tomcat 5 5 17 http tomcat apache org download 55 cgi 5 5 20 onix manager war 1 2 Installation 1 2 1 Variables d environnement Dans le fichier bashrc de l utilisateur qui lance Tomcat d clarer les variables suivantes export JAVA HOME r pertoire ou est install Java ex opt apache tomcat 5 5 17 export CATALINA HOME r pertoire ou est install tomcat ex opt jdk 1 2 2 Installer eXist Pour l installation d eXist il faut placer l archive exist 1 0rc war dans le r pertoire webApps de Tomcat Tomcat la d compacte automatiquement Une fois l archive decompact e renommer le r pertoire exist 1 0rc en exist puis se rendre sur la page d accueil d eXist qui pourrait tre http localhost 8080 exist index xml Dans le menu Administration admin entrer un nouvel utilisateur et mot de passe Manage users ou alors admin et mot de passe On utilisera ce log
15. sword 123 lastname DUPONT firstname lt CCO function relecteur websiteManagement false gt lt profilName gt relecteur lt profilName gt lt Ajouter la reference au profil gestion stock lt profilName gt gestion stock lt profilName gt gt lt pass type W gt lt path gt Product Subject lt path gt lt pass gt lt pass type NO W gt lt path gt Product Subject SubjectSchemeIdentifier lt path gt lt pass gt lt pass type NO R gt lt path gt Product Contributor lt path gt lt pass gt lt user gt Davy DERMILLY _ 05 octobre 2006 6 Onix manager productForPass xml Ce fichier contient tous les champs g r s par l appli cation Le modifier c est prendre le risque que l application ne fonctionne plus correctement Il est donc conseill d en garder une copie avant toute modification On peut remarquer que les champs sont pr remplis lt Product gt lt RecordReference gt 111 lt RecordReference gt lt NotificationType gt 03 lt NotificationType gt lt ProductIdentifier gt lt ProductIDType gt 02 lt ProductIDType gt lt IDValue gt Valeur premier ID lt IDValue gt lt Productidentifier gt lt Product gt Il est possible et m me conseill de changer la valeur de ces champs Car lorsque l on voudra ajouter par exemple un nouvel identifiant au pro duit que nous sommes en train de modifier via onix mana
Download Pdf Manuals
Related Search