Installation et Mise à Jour de BcdiWeb pour Linux version 2.0

Sommaire :

Présentation
Installation automatique
Installation manuelle
Paramétrer un nouvelle base après installation
Consultation de la base

BcdiWeb est diffusé en version CGI uniquement. Réalisé sous Borland/Kylix, ce programme autonome peut être utilisé sur toutes les distributions Linux avec Apache ou un autre serveur web.

Présentation :

BcdiWeb pour Linux est un CGI (Common Gateway Interface), c'est à dire un programme autonome utilisable par internet, permettant l'interrogation d'une ou plusieurs bases Bcdi depuis un client Web (Internet Explorer, Firefox, Mozilla, Netscape...). Tout serveur Web installé sur une machine Linux peut être utilisé, toutefois ce document ne décrit que l'installation sur serveur web Apache. Les fonctionnalités offertes sont identiques à celles proposées par BcdiWeb pour Windows :

• interrogation d'une base Bcdi  par un jeu d'écrans de recherche similaires aux écrans de Bcdi abonnement  (recherche par thèmes, auteurs, titre, collection, éditeur, thésaurus, multicritères et expert) ;
• consultation du compte de lecteur (liste de tous les prêts, des prêts en cours, des prêts en retard et des réservations) ;
• possiblité d'effectuer des réservations à distance ;
• possibilité d'afficher les couvertures, biographies, tables des matières et  4e de couv. dans les résultats de recherche pour les abonnés à MemoElectre et  MemoElectre+;
  
• possibilité de gérer un panier de notices ;
• fonctions de moteur de recherche sur une base Bcdi acceptant des requêtes dans un format propriétaire et renvoyant un flux XML Bcdi vers les clients web ;
• interrogation de plusieurs bases installées sur le même serveur web ;
• choix des écrans de recherche parmi 3 jeux (collège, lycée, adultes).

Installation automatique :

Téléchargez et décompactez l'archive à l'emplacement de votre choix (tar -xzvf BcdiWebLinux-2.0.tar.gz). Déplacez-vous dans le répertoire créé au décompactage (son nom est identique à celui de l'archive) et, en tant que root, lancez le script d'installation : ./installbcdiweb.pl ou perl installbcdiweb.pl

Le menu ci-dessous s'affiche :

                   *************************************************
                   *        Installation ou mise à jour du CGI          *
                   *             BCDIWEB v. 2.0  pour Linux                *
                   *************************************************


    1. Mise à jour du cgi
    2. Mise à jour rapide pour hébergeurs (modif. auto des fichiers ini)
    3. Première installation du cgi sans paramétrage d'Apache
    4. Première installation du cgi avec paramétrage d'Apache
    5. Quitter
    

Ce programme ne doit pas être utilisé pour mettre à jour Bcdi 3 Web
Problèmes d'affichage ?
Ce programme utilise le jeu de caractères ISO-8859-15. Réglez votre
console en conséquence.
La plupart des questions posées sont accompagnées d'une valeur par
défaut (chemin d'installation par ex.) ou des valeurs possibles de
la réponse (O/n pour oui ou non par ex.). Dans ce dernier cas la
valeur par défaut est en majuscules.
Pour sélectionner la valeur par défaut proposée dans la question,
appuyez simplement sur Entrée.

Votre choix :

Tapez le chiffre correspondant à l'action souhaitée et suivez les indications à l'écran.

Le choix 1 installe le nouveau cgi et ses modèles puis propose la modification de chaque fichier d'ini : ce choix convient pour la mise à jour d'un BcdiWeb donnant accès à peu de bases. 

Le choix 2 installe le nouveau cgi et ses modèles puis effectue la modification automatique de tous les fichiers d'ini : ce choix convient à la mise à jour d'un BcdiWeb donnant accès à un grand nombre de bases ou pour un administrateur pressé. Les fichiers d'ini sont renommés avant modification, il est donc possible de revenir en arrière si nécessaire.

Le choix 3 installe le cgi et ses modèles puis fournit les informations nécessaires au paramétrage d'Apache : une partie de l'installation est à effectuer manuellement, l'aide html (voir la rubrique Installation manuelle, ci-dessous) peut aussi vous aider.

Le choix 4 installe le cgi et ses modèles, règle les droits sur le répertoire progweb et effectue le paramétrage d'Apache (simple ajout d'une directive dans le fichier de conf d'Apache). 

Avant l'installation vous devez connaître :

• le nom d'établissement et la griffe de Bcdi Abonnement (choix 3 et 4) ;
• le nom et l'emplacement du fichier de conf. d'Apache (choix 4) ;
• le nom de l'utilisateur Web et de son groupe : notez qu'ils sont généralement déclarés dans le fichier de conf d'Apache (choix 4) ;
• le chemin de chaque base à mettre en ligne (choix  3 et 4) ;

Pour chacune des bases, vous devrez indiquer (choix 1, 3 et 4) :

• le chemin de la base, son nom dans l'url du site et le nom sous lequel elle doit apparaître dans les écrans de BcdiWeb ;
• le nom de l'établissement et sa griffe ;
• les écrans choisis parmi un choix de 3 modèles (collège, lycée, adultes) ;
• si les objets Electre (biographies, tables des matières, 4e de couv., couvertures) doivent être affichés (se reporter à la présentation des nouveautés pour les conditions d'utilisation) ;
• si les réservations en ligne sont autorisées ;
• si l'affichage de la marguerite dans les résultats de rechercher est souhaitée ;
• si la consultation du compte de chaque emprunteur par celui-ci est autorisée ;
• s'il s'agit d'une base bibliographique (sans mention des exemplaires dans les résultats affichés)
• les écrans de recherche choisis parmi 3 jeux (collège, lycée, adultes).

La présence du documentaliste à cette phase du paramétrage est nécessaire (ou celui-ci doit avoir répondu préalablement aux questions qui relèvent de son choix).

Dépendances :

Lors de la consultation des objets Electre, le cgi BcdiWeb fait appel à des bilbliothèques placée dans son répertoire d'installation. Il est nécessaire que le programme xsltproc (provenant d'un paquet de la distribution) soit présent dans le PATH du système (souvent placé dans /usr/bin) ; notez qu'en son absence, l'affichage des objets Electre fontionne, mais dans un mode dégradé.

Installation manuelle :

L'installation manuelle de BcdiWeb est possible : elle devrait être réservée aux cas particuliers pour lesquels l'installation automatique ci-dessus ne convient pas. On la consultera en cas de problème d'accès à une base, pour corriger manuellement des droits incorrects.

Pour l'installation manuelle, voir ce lien : installation_manuelle_bcdiweblinux.htm

Paramétrage d'une base après l'installation :

Déplacez-vous dans le répertoire contenant le cgi BcdiWeb et, en tant que root, lancez le script de paramétrage d'une nouvelle base : "./parambcdiweb.pl" ou "perl parambcdiweb.pl"
Le menu ci-dessous s'affiche :

                 *************************************************
                  *   Paramétrage d'une base de données      *
                  *     pour BCDIWEB v. 2.0 sous Linux             *
                  *************************************************


    1. Paramétrage d'une base
    2. Quitter


Problèmes d'affichage ?
Ce programme utilise le jeu de caractères ISO-8859-15. Réglez votre
console en conséquence.
La plupart des questions posées sont accompagnées d'une valeur par
défaut (chemin d'installation par ex.) ou des valeurs possibles de
la réponse (O/n pour oui ou non par ex.). Dans ce dernier cas la
valeur par défaut est en majuscules.
Pour sélectionner la valeur par défaut proposée dans la question,
appuyez simplement sur Entrée.

Votre choix :

Tapez le chiffre correspondant à l'action souhaitée et suivez les indications à l'écran.

Pour chacune des bases, vous devrez indiquer :

• le chemin de la base, son nom dans l'url du site et le nom sous lequel elle doit apparaître dans les écrans de BcdiWeb ;
• le nom de l'établissement et sa griffe ;
• les écrans choisis parmi un choix de 3 modèles (collège, lycée, adultes) ;
• si les objets Electre (biographies, tables des matières, 4e de couv., couverture) doivent être affichés (se reporter à la présentation des nouveautés pour les conditions d'utilisation) ;
• si les réservations en ligne sont autorisées ;
• si l'affichage de la marguerite dans les résultats de rechercher est souhaitée ;
• si la consultation du compte de chaque emprunteur par celui-ci est autorisée ;
• s'il s'agit d'une base bibliographique (sans mention des exemplaires dans les résultats affichés).

La présence du documentaliste à cette phase du paramétrage est nécessaire (ou celui-ci doit avoir répondu préalablement aux questions qui relèvent de son choix).

Consultation de la base :

La base Bcdi est accessible par un simple navigateur à l'adresse :

http://adresse_du_serveur/bcdi/bcdiweb.cgi/Data (vers les écrans de recherche de la base Data)
ou
http://adresse_du_serveur/bcdi/bcdiweb.cgi/Xxxx (vers les écrans de recherche de la base Xxxx)

Dans chaque répertoire de travail, un fichier de log, appelé par exemple bcdiweb_Data.log, stocke les requêtes adressées à Bcdi Web. Ce fichier au format csv (séparateur ";") est exploitable par un simple tableur. L'enregistrement des requêtes est automatique mais peut être débrayé en modifiant le paramètre correspondant dans le fichier d'ini de la base concernée.