Présentation Installation

Pré-requis à vérifier<ref>Demande de pré-requis pour Am-angers</ref>

Bonjour M. Dufresne,

Dans le cadre de la mise à jour de l'application Pleade nous avons un certains nombre de pré-requis. En voici la liste.

Début de la mise à jour Si cela vous convient, nous pouvons commencer la mise à jour mercredi en milieu de matinée.

Versions des applications Pouvez-vous nous communiquer les versions des applications installées suivantes :

   OS (debian/centOS de préférence) ;
   java (=1.6.x) ;
   Apache Tomcat (=6.x) ;
   Apache Httpd (=2.2.x) ;
   PostgreSQL ;
   ImageMagick ou GraphicsMagick

Organisation des données Pour faciliter notre travail, pouvez-vous nous communiquer une « cartes des ressources », à savoir les chemin vers :

   apache Httpd ;
   tomcat ;
   l'application installée ;
   les images/musiques/vidéos ;
   les documents XML
       les documents à publier ;
       les données d'indexation ;

Accès et Droits sur le serveur Pour travailler sur le serveur, nous avons besoin :

   d'accéder au serveur hébergeant l'application (notre ip est: 82.225.177.85). Merci de bien vouloir nous communiquer :
       l'adresse du serveur ;
       le port de communication (nous avons besoin d'accéder au ports 80 et 8080 pour tester) ;
       les identifiants de connexion au serveur (accès SSH de préférence).
   Une fois connecté sur le serveur de l'application, un accès root ou sudo serait le plus simple, et nous permettrai d'être autonome. Nous avons également besoin :
       d'accéder au serveur PostgreSQL (import/export/redémarrage) ;
           deux bases (db-front, db-back) ;
           deux utilisateurs (am-angers-front, am-angers-back), un pour chaque base.
       arrêter/redémarrer Tomcat ;
       arrêter/redémarrer Apache Httpd (éditer les fichiers de configuration) ;
       accéder aux dossiers contenant les ressources utiles à l'application (images, document XML-EAD, etc.)

Gestions des données

Merci de nous indiquer :

   est-ce que vous effectuer des sauvegardes ?
   est-ce que nous devons effectuer des pré-traitement sur les images (génération de miniatures) ?

Présentation

Ce document a pour objectif de :

1. indiquer comment installer et configurer les différents outils nécessaires pour la mise en ligne de l’application Pleade
2. fournir les détails relatifs à l’installation et la configuration de ces outils sur le serveur hébergeant cette application

Parmi les informations fournies dans ce document, on retrouve les procédures à suivre pour indexer les données, charger des contenus. Ces procédures permettent ainsi de faire plusieurs installations de l’application, avec des données. Pleade est un moteur de recherche et de publication d’instruments de recherche en format XML / EAD. Cet outil gère l’intégration du moteur de recherche documentaire. Il est associé à une visionneuse d’images qui prend en charge l’affichage des documents numérisés.

Warning

Ne perdez pas de vue qu’il s’agit d’une application Web XML. Cela implique quelques précautions de bases pour éviter les mauvaises surprises : éviter tout espace ou caractère accentué dans les chemins des différents fichiers ; faire particulièrement attention lors de l’édition des fichiers XML à produire un XML valide (la commande linux xmlwf vous aidera à vérifier ce point) et à utiliser l’encodage UTF–8 pour modifier ces fichiers.

Au fil de la documentation, vous pourrez rencontrer différentes variables en référence à Pleade :

Variables relatives à Pleade Variable Définition {PleadeDir} Dossier d’installation de Pleade {Datadir} Dossier dans lequel seront stockés les index, etc. {BddPleade} [1] Base de données où sont stockées les données d’indexation {EadDir} Dossier contenant les fichiers sources. XML EAD {Peadeurl} URL d’accès à l’application Les valeurs des différentes variables est fournies en Annexe A.

Architecture

Pleade est une application Web développée dans une architecture Java et s’appuie sur un SGBDR. Elle repose donc fondamentalement sur quatre composantes fonctionnelles essentielles :

• une machine virtuelle Oracle Java <ref>Oracle JAVA: http://www.oracle.com/technetwork/java/javase/downloads/index.html</ref> [2].
• Un serveur d’applications J2EE : Tomcat 6 [3] recommandé.
• Un SGBDR qui sera utilisé pour stocker certaines données de gestion liées à l’indexation. Pleade supporte actuellement les moteurs de bases de données suivants :
  • HSQL (déconseillé en production)
  • PostgreSQL 8 (recommandé). PostgreSQL 8.2 minimum est requis pour utiliser le panier d’images persistant.
  • MySQL 5
  • MSSQL
  • Oracle

• Un outil de traitement d’images : ImageMagick [4] ou GraphicsMagick [5].

De façon optionnelle :

• Un serveur Web (HTTP) : Apache [6] recommandé

Pré-requis

Le serveur sur lequel est installé l’application Pleade doit avoir :

• Un accès aux espaces de stockage où se trouvent les documents à publier ainsi que les documents associés (images, etc.). Cet accès est de type « système de fichiers » et il est en lecture seulement.
• Un accès à un espace de sauvegarde où stocker les sauvegardes des images, de l’application ainsi que de ses données, des documents XML EAD.

Composants

L’installation de l’application Pleade consiste à installer et/ou configurer l’accès à ses différents composants, et ensuite installer et configurer l’application elle-même.

A noter que Pleade et tous ses composants fonctionnent sur différents systèmes d’exploitation. L’application a notamment été testée sur des plates-formes :

• GNU/Linux
  • Fedora,
  • CentOS,
  • Suse
  • …,

• Windows
  • Windows 2003 Server,
  • Windows 2008 Server,
  • …

• Mac OS X.

Au fil de la documentation, vous pourrez rencontrer différentes variables en référence aux composants :

Variables relatives aux composants Variable Définition {serveur_http} Fichier de configuration du serveur HTTP dédié à Pleade {java} Dossier d’installation de Java {serveur_j2ee} Dossier d’installation de Tomcat {imagemagick} Exécutable ImageMagick {serveur_sql} Dossier principal de stockage des données dans la base Les valeurs des différentes variables est fournies en Annexe B.

Note

À des fins d’harmonisation, nous utiliserons toujours la barre oblique « / » comme séparateur de chemin, et ce même si l’installation a lieu sous Windows.

Warning

Dans certains fichiers de configuration, tout comme dans les documents EAD, il ne faut pas utiliser la barre oblique inversée (« \ ») pour séparer les chemins, même sous Windows.

• [1] Lorsque le moteur de base de données HSQL est utilisé, la base de données sera stockée dans {Datadir}.
• [2] http://www.oracle.com/technetwork/java/javase/downloads/index.html
• [3] http://tomcat.apache.org/download–60.cgi
• [4] http://www.imagemagick.org/
• [5] http://www.graphicsmagick.org/
• [6] http://httpd.apache.org

References

<references/>