Dilib, installation et compilation
  |
Cette page décrit comment, téléverser, installer et compiler la Bibliothèque Dilib.
|
Liste des modules Dilib
|
Modes
Il est prévu d'implanter 2 versions[1] de la bibliothèque :
- Main, pour les opérations courantes, avec des possibilités étendues de déverminage ;
- Fast, pour les opérations demandant une forte performance.
A l'heure actuelle, seul le mode Main est opérationnel.
|
L'installation de Dilib est en cours de re-définition. |
Hiérarchie
Généralités
La bibliothèque Dilib est installée sous forme d'une hiérarchie permettant de compiler des versions de performances différentes.
Nous distinguerons 2 types principaux d'installation :
- Pour permettre une souplesse dans les exploitations de corpus nous recommandons une installation sur le répertoire de l'utilisateur. Toute la documentation est rédigée dans ce cadre.
- Il est également possible d'installer la bibliothèque comme ressource commune.
Pour en savoir plus, voir Dilib, hiérarchie
Répertoire utilisateur
La bibliothèque Dilib peut être placée sous le répertoire de l'utilisateur. Il n'est pas nécessaire de distinguer les sous-versions dans les cas courants.
La hiérarchie recommandée est alors la suivante :
~ + répertoire d'accueil de l'usager (home directory)
+- Dilib + $DILIB_BOTTOM
+ init.sh lien vers Main/init.sh
+ Versions anciennes éventuelles
+ V0.6.38 + $DILIB_ROOT
| +- Import - les sources
| +- Main - version principale $DILIB
+ tmp répertoire à utiliser pour la compilation
Site de développement ou serveur Web
...+
+ Dilib + $DILIB_BOTTOM
|
+ V0.6 + ...
+ V0.6.3 + ...
+ V0.6.38 + $DILIB_ROOT
+- Import - les sources
+- Main - version principale $DILIB
+- ( Fast - Version compilée en mode fast )
- $DILIB_BOTTOM : la racine de l'arborescence contenant les versions Dilib,
- $DILIB_ROOT : la racine de la version actuelle (V0.6.38)
- $DILIB : l'arborescence visible par l'utilisateur
Installation compilation sur un nouveau site
Préparation de la hiérarchie
Seule la procédure simplifiée orientée utilisateur est détaillée ici
Créer les répertoires d'installation :
mkdir Dilib mkdir Dilib/V0.6.38 mkdir Dilib/V0.6.38/Main mkdir Dilib/tmp mkdir WicriRoot mkdir WicriRoot/Wicri
Téléchargement
- se placer sous le répertoire
V0.6.38et y installer :Import.tar.gzet . - puis :
gunzip Import.tar.gz
tar -xvf Import.tar
gunzip ImportData.tar.gz
tar -xvf ImportData.tar
Adaptations locales
Sous Main, adapter les fichier init.sh et MakeDef.mk à partir :
- d'un ensemble de modèles qui se trouvent sous
$DILIB_ROOT/Import/DilibMake/Templates/
ls ...V0.6.38/Import/DilibMake/Templates
- pour MacBook voir Dilib, module DilibMake, templates, MacBook
- Pour le système Ubunto, faire :
cp ...V0.6.38/Import/DilibMake/Templates/UbuntoMain/MakeDef.mk ...V0.6.38/Main/MakeDef.mk cp ...V0.6.38/Import/DilibMake/Templates/UbuntoMain/init.sh ...V0.6.38/Main/init.sh
Si Dilib n'est pas installée sous le répertoire d'accueil, vérifier impérativement ../Main/init.sh pour instancier correctement $DILIB_ROOT.
Compilation de la version Main
- appeler init.sh par une commande du type (celle qui suit est valable sur un site d'utilisation simple) :
source ...Dilib/V0.6.38/Main/init.sh
- vérifier en faisant
echo $DILIB_ROOT
- aller sur un répertoire de travail, exemple :
cd $DILIB_BOTTOM/tmp
- compiler par :
source $DILIB_ROOT/Import/DilibMake/DilibCreate.sh
- vérifier le bon fonctionnement par :
source $DILIB_ROOT/Import/DilibMake/DilibTest.sh
- pour rendre l'installation relativement indépendante des changements de version, faire :
cd $DILIB_BOTTOM ln -s V0.6.38/Main/init.sh init.sh
Mises à jour partielles
Mise à jour du répertoire Data
Récupérer Data.tar.gz
Depuis le site de développement
scp Data.tar.gz user@lorexplor-nat.istex.fr:/home/user/Dilib/V0.6.29
Puis
puis :
gunzip Data.tar.gz
tar -xvf Data.tar
Problèmes d'installation
Liés à la compilation
La bibliothèque DILIB a besoin d'un ensemble de ressources qui peuvent s'installer ainsi :
sudo apt-get install flex
Installation de la bibliothèque CURL:
sudo apt-get install libcurl4-gnutls-dev
Après chaque problème de ce type, reprendre la compilation par :
source $DILIB_ROOT/Import/DilibMake/DilibUpdate.sh
Pour faire fonctionner un site local
Installation des paquets apache2, php5, mysql-server: Texte gras
Pour installer apt-get install libcurl4-gnutls-devces paquets, on doit utiliser la commande suivante :
sudo apt-get install apache2 php5 mysql-server libapache2-mod-php5 php5-mysql
Description des paquets :
- Le paquet apache2 installe le serveur Apache 2.
- Le paquet php5 installe le langage PHP 5
- Le paquet mysql-server installe le serveur MySQL.
Simple mise à jour (changement de version)
Procéder à l'initialisation des variables locales sous la dernière version installée
source ...Dilib/init.sh
Créer les répertoires d'accueil de la nouvelle version
mkdir $DILIB_BOTTOM/V0.6.38 mkdir $DILIB_BOTTOM/V0.6.38/Main
Recopier les fichiers d'adaptation locales
cp $DILIB/init.sh $DILIB_BOTTOM/V0.6.38/Main/init.sh cp $DILIB/MakeDef.mk $DILIB_BOTTOM/V0.6.38/Main/MakeDef.mk
Adapter :
$DILIB_BOTTOM/V0.6.38/Main/init.sh
Se placer sous le répertoire $DILIB_BOTTOM/V0.6.38 et y installer :
Import.tar.gz
- puis décompresser la hiérarchie :
gunzip Import.tar.gz
tar -xvf Import.tar
Modifier le lien implicite sur le fichier d'initialisation et réinitialiser vers la nouvelle version.
cd $DILIB_BOTTOM rm init.sh ln -s V0.6.38/Main/init.sh init.sh . init.sh
Compiler et vérifier
cd $DILIB_BOTTOM/tmp . $DILIB_ROOT/Import/DilibMake/DilibCreate.sh . $DILIB_ROOT/Import/DilibMake/DilibTest.sh
Voir aussi
- Notes
- ↑ Pour mémoire, la bibliothèque Dilib (version Inist) pouvait être compilée sous 2 modes : Main ou Test. Nous avons ici préféré privilégier le mode test.
- ↑ La configuration installée sur la machine Ticri supportera les 2 versions d'exécution Main et Fast.
- ↑ Par rapport aux versions précédentes (Inist), il n'y a plus de site Web. Ce wiki en tient lieu.
- Sur ce wiki
