<HTML>
<HEAD>
<TITLE>Procédure d'installation</TITLE>
</HEAD>
<BODY>
<H1>3. <A NAME="s3"></A>Procédure d'installation</H1>
<P>
<A HREF="WWW-mSQL-HOWTO.html#toc3">Contenu de cette section</A></P>
<H2>3.1 <A NAME="ss3.1"></A> Matériel requis</H2>
<P>Aucune supposition ne peut être faite sur les besoins en matériel d'un serveur de base de
données. Cela dépend trop du nombre d'utilisateurs, du type d'application, de la charge du réseau,
etc. Dans un environnement comprenant peu d'utilisateurs et un trafic réseau faible, un 486 ou équivalent,
avec 16 MO de mémoire vive, peut être suffisant. Linux, le système d'exploitation, est très efficace
en termes de ressources, et peut fournir suffisamment de puissance pour faire tourner un grand nombre
d'applications en même temps. Bien sûr, un processeur plus puissant et plus de mémoire vive signifient
plus de puissance, mais la quantité de mémoire vive est plus importante que le processeur. Plus le
système a de mémoire vive, moins il est obligé, en cas de besoin, de swapper les processus
les plus gourmands en mémoire sur le disque.</P>
<P></P>
<P>Avec un système équipé de 32 MO de mémoire vive et d'un bus PCI, les recherches et opérations de
tri peuvent être faites sans avoir recours au(x) fichier(s) d'échange (swap), donnant d'excellents résultats.</P>
<P></P>
<P>L'installation décrite dans cet article a été faite sur un IBM 686 à 133MHz, avec 32 MO de mémoire vive et
un disque dur IDE de 1.2 GO. La suite du document présente les étapes indispensables à une installation complète.</P>
<P></P>
<H2>3.2 <A NAME="ss3.2"></A> Logiciel</H2>
<P>Les logiciels décrits dans cet article sont disponibles sur Internet, ou sur CD-ROM. Les produits suivants sont utilisés :</P>
<P>
<UL>
<LI> Distribution Red Hat 4.2, parue pendant l'été 1997, disponible sur CD-ROM (Red Hat Linux
PowerTools : 6 CD-ROM complets et prêts à être utilisés) ou sur Internet, sur le site de
<A HREF="http://www.redhat.com">RedHat</A>
;
</LI>
<LI> Base de données SQL msql : disponible en deux versions. Les différences entre ces deux versions résident
dans le nombre maximum de transactions supporté, l'interface d'administration, etc. La version la plus ancienne,
1.0.16, est disponible sur les sites miroirs de Sunsite. L'exécutable au format ELF peut être trouvé sur
<A HREF="http://sunsite.unc.edu/pub/Linux/apps/database/sql/msql-1.0.16">Sunsite</A>
, ou sur CD-ROM (en l'occurrence le disque
4 de l'InfoMagic Linux Developper's Resource, ensemble de 6 CD-ROM, décembre 1996), ou chez
<A HREF="http://www.infomagic.com">InfoMagic</A>
. La version la plus récente, 2.0.1, peut être obtenue directement de la page
Web d'
<A HREF="http://www.hughes.com.au">Hughes</A>
, en Australie, ou sur de nombreux sites miroirs dans le monde ;
</LI>
<LI> Perl du CPAM : The Comprehensive Perl Archive Network. Sur le CD-ROM WalnutCreek, ISBN 1-57176-077-6, mai 1997 ;
</LI>
<LI> L'exemple de programme CGI de Michael Schilli, dans le magazine informatique iX d'août 1997, pages 150-152,
disponible par
<A HREF="ftp://ftp.uni-paderborn.de/doc/magazin/iX/">ftp</A>
.
</LI>
</UL>
</P>
<P></P>
<P></P>
<H2>3.3 <A NAME="ss3.3"></A> Installation de l'OS</H2>
<P>Linux est installé à partir de la distribution Red Hat Linux 4.2. Pour réussir à l'installer,
la machine doit avoir un lecteur de CD-ROM accessible à partir de MSDOS, un lecteur de CD-ROM
bootable, ou bien encore une disquette de boot préparée selon les instructions du CD Linux.</P>
<P></P>
<P>Pendant l'installation, l'utilisateur peut sélectionner et configurer de nombreux paquetages
logiciels. Il convient de sélectionner les suivants :</P>
<P></P>
<P>
<UL>
<LI> support du protocole TCP/IP</LI>
<LI> le serveur http Apache</LI>
<LI> le langage Perl</LI>
<LI> le système XWindow</LI>
<LI> les navigateurs Arena (graphique) et Lynx (mode texte).</LI>
</UL>
</P>
<P></P>
<P>Tous ces paquetages sont fournis avec la distribution Linux. Si vous ne les installez pas
maintenant, vous pourrez le faire plus tard en utilisant <CODE>glint</CODE>, le gestionnaire graphique de
paquetages logiciels. Assurez-vous d'être connecté comme utilisateur <CODE>root</CODE> lorsque vous les installerez.</P>
<P></P>
<P>Il n'est pas du ressort de cet article de décrire l'installation réseau, ni la procédure d'initialisation.
Pour cela, consultez la documentation en ligne (pages de manuel, HTML, texinfo) et imprimée (Bible Linux, etc.).</P>
<P></P>
<P>La procédure d'installation de Red Hat est très au point et nécessite peu d'interaction de la part de
l'utilisateur, en dehors des choix courants (les noms de machines, par exemple). Une fois
l'installation terminée, le système est prêt à tourner.</P>
<P></P>
<P>L'installation de XWindow n'est pas obligatoire pour le serveur, mais cela rend les accès locaux et les
tests plus faciles. La procédure d'installation de XWindow peut être conduite par différents programmes ; XF86Setup
offre le plus de facilité d'auto-test, et demande peu de connaissance des menus détails (la programmation
de l'horloge vidéo, etc.). La seule contrainte est que le logiciel puisse détecter l'adaptateur vidéo.
Des cartes graphiques accélératrices bon marché (comme les cartes basées sur le chip Trio S64, avant le S64UV+)
fonctionnent sans aucun problème.</P>
<P></P>
<P>A partir de maintenant, nous supposons que le système tourne, et que Apache, Perl et XWindow ont été
installés avec succès. Nous supposons de même que les fichiers et structure de répertoires sont tels que
définis dans l'installation. Enfin, nous laissons le nom de la machine tel quel, et pour le moment, supposons
que c'est <CODE>localhost</CODE>. Nous utiliserons ce nom pour tous les tests d'installation ; dès que le système
fonctionnera, le véritable nom pourra être ajouté. Notez que l'installation réseau suppose d'éditer le
fichier <CODE>/etc/hosts</CODE>, entre autres. Cela peut être pris en charge par les outils d'administration fournis
à l'utilisateur root.</P>
<P></P>
<H2>3.4 <A NAME="ss3.4"></A> Le serveur HTTP</H2>
<P>Le serveur HTTP fourni avec Linux est Apache, <CODE>httpd</CODE> pour le système. La page de manuel (<CODE>man httpd</CODE>) explique
comment installer et démarrer le démon http (donc http<EM>d</EM>) mais, comme il a été indiqué plus haut, si l'installation
s'est bien passée, le serveur HTTP doit tourner. Vérifiez l'arborescence des répertoires : le répertoire
<CODE>/home/httpd</CODE> doit exister, avec trois sous-répertoires : <CODE>../cgi-bin/</CODE>, <CODE>../html/</CODE> and <CODE>../icons/</CODE>.
Dans <CODE>../html/</CODE>, vous devez trouver un fichier <CODE>index.html</CODE>. Plus tard, nous modifierons ou remplacerons
ce fichier par notre propre <CODE>index.html</CODE>. Toute la configuration se fait dans le fichier <CODE>/etc/httpd/conf/</CODE>.
Le système est correctement préconfiguré et ne doit pas être modifié, si l'installation s'est faite sans problème.</P>
<P></P>
<H2>3.5 <A NAME="ss3.5"></A> Les navigateurs</H2>
<P></P>
<P>Il existe trois types de navigateurs disponibles sous Linux : les logiciels purement textuels, comme Lynx, des
logiciels simples et expérimentaux comme Arena (gratuit) et des logiciels commerciaux, comme Netscape (partagiciel !)
avec support de Java intégré. Alors que Lynx et Arena sont fournis avec Linux, Netscape doit être récupéré par
d'autres sources. Netscape est disponible sous forme de fichier binaire précompilé pour Linux sur architecture ix86
et tourne "tel quel" une fois l'archive décompressée.</P>
<P></P>
<H3>Configuration de Lynx</H3>
<P>Une fois Lynx démarré, il cherche une 'URL par défaut' qui n'existe pas toujours si le système n'a pas d'accès Internet
permanent. Pour changer cette URL par défaut (ainsi que d'autres détails de configuration), l'administrateur doit éditer
le fichier <CODE>/usr/lib/lynx.cfg</CODE>. Ce fichier est gros, environ 57000 octets, et contient des informations
quelquefois contradictoires. Il établit son propre répertoire dans <CODE>/usr/local/lib</CODE>. Au début du fichier figure
une ligne commençant par <CODE>STARTFILE</CODE>. Remplacez cette ligne par la suivante : <CODE>STARTFILE:http://localhost</CODE>,
en vous assurant qu'il n'y a pas d'espace en trop :</P>
<P>
<HR>
<PRE>
# STARTFILE:http://www.nyu.edu/pages/wsn/subir/lynx.html
STARTFILE:http://localhost
</PRE>
<HR>
</P>
<P>Après avoir enregistré le fichier, Lynx doit maintenant ouvrir notre <CODE>index.html</CODE> s'il est lancé sans argument.</P>
<P></P>
<H3>Configuration d'Arena</H3>
<P>S'il est lancé sans argument, Arena recherche son URL par défaut. Cette URL est codée en dur dans l'exécutable,
mais peut être redéfinie en utilisant la variable d'environnement <CODE>WWW_HOME</CODE>. L'administrateur système peut placer
la ligne suivante dans le fichier <CODE>/etc/profile</CODE> : <CODE>WWW_HOME="http://localhost"</CODE>. Cette variable doit
être exportée, soit par l'ajout de la ligne adéquate (<CODE>export WWW_HOME</CODE>), soit en ajoutant <CODE>WWW_HOME</CODE>
à la ligne d'export courante :</P>
<P>
<HR>
<PRE>
WWW_HOME="http://localhost"
export WWW_HOME
</PRE>
<HR>
</P>
<P>A la prochaine connexion, la nouvelle URL par défaut d'Arena sera connue du système.</P>
<P></P>
<H3>Installation et Configuration de Netscape</H3>
<P>Netscape était un produit commercial, et n'est donc pas inclus dans les anciennes distributions Linux. Néanmoins, il
est téléchargeable par Internet, ou accessible à partir de certaines compilations de logiciels sur CD-ROM. Netscape est
fourni sous la forme de fichiers binaires précompilés pour les plates-formes les plus courantes. Avant de l'installer, il
est utile de créer le répertoire <CODE>/usr/local/Netscape</CODE>, dans lequel l'archive sera décompactée. Tous les fichiers
doivent rester à cette place (sauf la bibliothèque Java : suivez les instructions du fichier <CODE>README</CODE> fourni avec les
binaires de Netscape), et il suffira de créer un lien symbolique avec <CODE>/usr/local/bin</CODE> par la commande :</P>
<P>
<PRE>
# ln -s /usr/local/Netscape/netscape .
</PRE>
</P>
<P>depuis le répertoire <CODE>/usr/local/bin/.</CODE></P>
<P></P>
<P>Netscape est maintenant pret à être utilisé, et peut être configuré par le menu "Options". Dans "General Preferences", il y
a un onglet intitulé "Appearance", avec un champ de saisie "Home Page Location". Tapez <CODE>http://localhost</CODE>, et
n'oubliez pas de sauvegarder les options (par le menu "Options" -- "Save Options") avant de quitter Netscape. Au
prochain démarrage, Netscape présentera la page d'accueil d'Apache.</P>
<P></P>
<H2>3.6 <A NAME="ss3.6"></A> Les navigateurs avec Apache</H2>
<P>Faites maintenant le premier test d'Apache avec un navigateur : lancez simplement l'un des navigateurs disponibles, et il
affichera la page d'accueil <CODE>Apache : Red Hat Linux Web Server</CODE>. Cette page indique la localisation des fichiers
et d'autres informations concernant l'installation du serveur http.
Si cette page ne s'affiche pas, vérifiez que les fichiers cités plus haut sont bien en place et que la configuration du
navigateur est correcte. Fermez les fichiers de configuration avant de démarrer de nouveau le navigateur. Si tous les
fichiers sont installés et que le navigateur semble correctement configuré, examinez la configuration du réseau. Ou
bien le nom de votre machine est différent de celui spécifié lors de la configuration, ou bien la configuration réseau
n'est pas correcte. Il est particulièrement important que <CODE>/etc/hosts</CODE> contienne au moins la ligne suivante :</P>
<P>
<HR>
<PRE>
127.0.0.1 localhost localhost.localdomain
</PRE>
<HR>
</P>
<P>qui suppose que vous pouvez vous connecter localement. Vous pouvez le vérifier en lançant une commande réseau qui réclame
un nom de machine comme argument, comme <CODE>telnet localhost</CODE> (en supposant que <CODE>telnet</CODE> soit installé). Si cela ne
fonctionne pas, la configuration réseau doit être controlée avant de continuer l'intallation.</P>
<P></P>
<H2>3.7 <A NAME="ss3.7"></A> La Base de données et son installation</H2>
<P>L'installation de la base de données demande à peine plus de préparation que les étapes précédentes. Il y a quelques
moteurs de base de données SQL disponibles, avec des contraintes d'administration et d'exécution différentes ; l'un des
plus simples est msql, dit aussi "Mini-SQL", écrit par David Hughes. Msql est un "partagiciel". En fonction de la version
utilisée, les sites commerciaux sont redevables de 250 US$, voire plus, les utilisateurs privés d'au moins 65 US$, et
seules les institutions scolaires et les entreprises à but non lucratif peuvent utiliser ce logiciel librement. Les
termes exacts des droits figurent dans la documentation de la base de données. Les éléments données ici ne sont qu'indicatifs.</P>
<P></P>
<P>Tout d'abord, voici en quelques mots pourquoi l'auteur a choisi msql. Il y a tout d'abord une expérience personnelle.
Alors qu'il cherchait une base de données, l'auteur a trouvé que msql était la plus facile à installer et à maintenir,
et qu'elle couvrait un ensemble suffisamment large du langage SQL pour convenir à une utilisation classique. C'est
seulement en écrivant ces lignes que l'auteur a découvert cette éloge dans la DBI FAQ d'Alligator Descartes (la FAQ
interface perl aux bases de données) :</P>
<P></P>
<P></P>
<P>
<BLOCKQUOTE><CODE>
Du point de vue de l'auteur, si le volume de données est relativement faible, les tables contenant moins d'1 million de
lignes, avec moins de 1000 tables dans une base donnée, alors msql constitue une solution parfaitement acceptable. Cette
base de données est très bon marché, extraordinairement solide, et offre un excellent support, ...
</CODE></BLOCKQUOTE>
</P>
<P></P>
<P>Mqsl est disponible en deux versions, msql-1.0.16 et msql-2.0.1, qui diffèrent par leurs performances (cela n'est sensible
que sur des petits projets) et les logiciels les accompagnant (la version la plus récente dispose de plus d'outils, de
son propre langage de script, etc.). Nous décrirons les deux versions de msql, car leurs installations se distinguent par
quelques aspects.</P>
<P></P>
<H3>Installation de msql-1.0.16</H3>
<P>Msql est disponible sous forme de sources et de binaires précompilés au format ELF. L'utilisation des binaires ELF rend
l'installation plus simple, car l'archive <CODE>msql-1.0.16.ELF.tgz</CODE> contient une copie de l'arborescence
d'installation, pour que les répertoires soient générés correctement lors du décompactage dans le répertoire <CODE>/</CODE>.</P>
<P></P>
<P>Si vous décidez de compiler msql-1.0.16 vous-même, et que vous voulez utiliser le paquetage MsqlPerl plutot que
l'interface DBI (voir plus loin une présentation détaillée des différence entre les deux stratégies), alors
attendez-vous à ce que MsqlPerl rapporte, lors des tests d'installation, des erreurs dans msql. Dans ce cas, une
correction sera nécessaire, expliquée dans la documentation MsqlPerl (fichier <CODE>patch.lost.tables</CODE>). En
l'occurrence, il faut inclure les trois lignes suivantes dans <CODE>msqldb.c</CODE>, après la ligne 1400, contenant
<CODE>entry->def = NULL;</CODE> :</P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
*(entry->DB) = 0;
*entry->table) = 0;
entry->age = 0;
</PRE>
</CODE></BLOCKQUOTE>
</P>
<P>Cette partie de code doit maintenant être la suivante :</P>
<P>
<HR>
<PRE>
freeTableDef(entry->def);
safeFree(entry->rowBuf);
safeFree(entry->keyBuf);
entry->def = NULL;
*(entry->DB) = 0;
*entry->table) = 0;
entry->age = 0;
</PRE>
<HR>
</P>
<P>La compilation de msql comprend plusieurs étapes. Après avoir décompacté l'archive contenant les sources, il faut
créer un répertoire destination. Cela se fait avec la commande suivante :</P>
<P>
<PRE>
# make target
</PRE>
</P>
<P>Si tout se passe bien, le système répond avec</P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
Build of target directory for Linux-2.0.30-i486 complete
</PRE>
</CODE></BLOCKQUOTE>
</P>
<P>Vous pouvez maintenant aller dans le répertoire que vous venez de créer, et taper d'abord la commande</P>
<P>
<PRE>
# ./setup
</PRE>
</P>
<P>La séquence <CODE>./</CODE> est nécessaire pour s'assurer que la commande <CODE>setup</CODE> exécutée est bien celle du
répertoire courant, et non une autre qui aurait le même nom. On va maintenant vous poser quelques questions
concernant le répertoire source, et la localisation du répertoire d'installation. Une fois que ces questions
ont eu leur réponse, le système lance quelques tests pour vérifier que les logiciels nécessaires (compilateurs,
utilitaires divers, etc.) sont présents, puis finalement répond</P>
<P>
<BLOCKQUOTE><CODE>
Ready to build mSQL.
<P>You may wish to check "common/site.h" although the defaults should be fine. When you're ready, type "make all"
to build the software</P>
</CODE></BLOCKQUOTE>
</P>
<P>Il faut alors taper</P>
<P>
<PRE>
# make all
</PRE>
</P>
<P>Si tout fonctionne comme prévu, nous devons alors lire :</P>
<P>
<BLOCKQUOTE><CODE>
make<F>2</F> : leaving directory '/usr/local/Minerva/src/msql' <-- <F>msql</F> done
<P>Make of mSQL complete.
You should now install mSQL using make install</P>
<P>NOTE : mSQL cannot be used free of charge at commercial sites.
Please read the doc/License file to see what you have to do.</P>
<P>make<F>1</F> : Leaving directory '/usr/local/Minerva/src'</P>
</CODE></BLOCKQUOTE>
</P>
<P>Tous les binaires doivent être accessibles, par exemple en créant des liens symboliques dans <CODE>/usr/local/bin/</CODE>.
Déplacez-vous dans ce répertoire et tapez la commande</P>
<P>
<BLOCKQUOTE><CODE>
# ln -s /usr/local/Minerva/bin/* .
</CODE></BLOCKQUOTE>
</P>
<P>après quoi les liens sont correctement construits.</P>
<P></P>
<H3>Test de msql-1</H3>
<P>Après l'installation, il est maintenant possible de tester le fonctionnement de la base de données. Avant toutes choses,
le serveur doit être démarré. L'administrateur système, grâce aux privilèges du compte utilisateur <CODE>root</CODE>,
lance la commande</P>
<P>
<PRE>
# msqld &
</PRE>
</P>
<P>(n'oubliez pas d'ajouter le <CODE>&</CODE>, sinon msql ne tournerait pas en tâche de fond.), après quoi le message suivant doit apparaître :</P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
mSql Server 1.0.16 starting ...
Warning : Couldn't open ACL file : No such file or directory
Without an ACL file global access is Read/Write
</PRE>
</CODE></BLOCKQUOTE>
</P>
<P>Ce message indique que tout fonctionne correctement, à part la configuration des droits d'accès. Pour le moment, il
suffit de démarrer le serveur msql à partir d'un shell, mais vous pourrez par la suite vouloir le démarrer automatiquement
au lancement du système. Cette commande doit alors être ajoutée dans un des scripts du répertoire <CODE>rc.d</CODE>. Seul
l'administrateur système peut lancer la première commande typique d'une base de données (création de la première table) :</P>
<P>
<PRE>
# msqladmimn create inventur
</PRE>
msql répond alors <CODE>Database "inventur" created</CODE>. Comme preuve supplémentaire, vous pouvez constater que le
répertoire <CODE>/usr/local/Minerva/msqldb/</CODE> contient maintenant le répertoire <CODE>../inventur</CODE>, vide pour
l'intant. Vous pouvez manipuler la nouvelle base avec les outils d'administration, qui sont décrits en détail dans
la documentation msql.</P>
<P></P>
<H3>Installation de msql-2.0.1</H3>
<P>Une nouvelle version, plus puissante, du serveur mSQL d'Hugues est maintenant disponible. Son installation est un
peu différente. Installer msql-2 de zéro nécessite les étapes suivantes. Copiez l'archive à l'endroit où vous souhaitez
l'installer, par exemple <CODE>/usr/local/msql-2/</CODE>, puis décompressez-la :</P>
<P>
<PRE>
# tar xfvz msql-2.0.1.tar.gz
</PRE>
</P>
<P>Positionnez vous à la racine de l'arborescence d'installation et tapez</P>
<P>
<PRE>
# make target
</PRE>
</P>
<P>Placez vous dans le répertoire <CODE>targets</CODE> et vérifiez le type de votre machine. Il devrait y avoir un nouveau
sous-répertoire <CODE>Linux-<EM>(votre version)-votre cpu)</EM></CODE>. Allez dans ce répertoire et lancez l'utilitaire
de configuration qui s'y trouve :</P>
<P>
<PRE>
# ./setup
</PRE>
</P>
<P>Il y a aussi un fichier <CODE>site.mm</CODE> qui peut être édité. Peut-être avez-vous déjà utilisé le répertoire
<CODE>/usr/local/Minerva/</CODE> et souhaitez-vous le conserver intact ? Dans ce cas, changez la ligne <CODE>INST_DIR=...</CODE> pour
indiquer le répertoire destination qui vous convient. Sinon, ne changez rien.</P>
<P></P>
<P>Maintenant, vous pouvez contruire la base de données :</P>
<P>
<PRE>
# make
# make install
</PRE>
</P>
<P>Si tout marche bien, vous verrez ce message :</P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
[...]
Installation of mSQL-2 complete.
*********
** This is the commercial, production release of mSQL-2.0
** Please see the README file in the top directory of the
** distribution for license information.
*********
</PRE>
</CODE></BLOCKQUOTE>
</P>
<P>Une fois que tout est installé correctement, vous devez vous préoccuper de certains détails d'administration. C'est
ici que les différences avec msql-1 commencent. D'abord, un utilisateur <CODE>msql</CODE> est créé, et est responsable de
l'administration de la base de données.</P>
<P>
<PRE>
# adduser msql
</PRE>
</P>
<P>Maintenant, vous devez changer les propriétaire et groupe de tous les fichiers dans le répertoire de mSQL en tapant :</P>
<P>
<PRE>
# cd /usr/local/Minerva
# chown -R msql:msql *
</PRE>
</P>
<P>Enfin, vous pouvez créer les liens symboliques pour tous les éxecutables de la base de données dans <CODE>/usr/local/bin/</CODE>
en lançant la commande :</P>
<P>
<PRE>
# ln -s /usr/local/Minerva/bin/* .
</PRE>
</P>
<P></P>
<P></P>
<H3>Test de msql-2</H3>
<P>Démarrez maintenant le serveur de la base en tapant la commande <CODE>msql2d &</CODE>, vous devriez obtenir cette réponse :</P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
Mini SQL Version 2.0.1
Copyright (c) 1993-4 David J. Hugues
Copyright (c) 1995-7 Hughes Technologies Pty. Ltd.
All rights reserved.
Loading configuration from '/usr/local/Minerva/msql.conf'.
Server process reconfigured to accept 214 connections.
Server running as user 'msql'.
Server mode is Read/Write.
Warning : no ACL file. Using global read/write access.
</PRE>
</CODE></BLOCKQUOTE>
</P>
<P></P>
<P>Tout est parfait. La base est compilée et installée, et nous pouvons maintenant continuer avec les modules perl
puisqu'ils demandent la présence d'un serveur de base de données opérationnel pour les tests.</P>
<P></P>
<P>Au fait, ce moment est bien choisi pour imprimer la documentation complète livrée avec msql-2.0.1 :</P>
<P>
<PRE>
# gzip -d manual.ps
# lpr manual.ps
</PRE>
</P>
<P>Nous pouvons maintenant poursuivre la mise en place des interfaces, mais il est judicieux de laisser le nouveau
serveur SQL tourner: cela ne fera que faciliter les tests des bibliothèques d'interface.</P>
<P></P>
<H2>3.8 <A NAME="ss3.8"></A> Les différentes Interfaces : DBI/mSQL, MsqlPerl, et Lite</H2>
<P>Une phrase fréquemment citée dans le Camel Book (la documentation de référence de perl) affirme qu'il y a toujours
plusieurs manières d'obtenir un résultat avec perl. Hélas, cela est vrai aussi avec notre application. Il y a trois
méthodes pour accéder à une base de données msql par l'intermédiaire de CGI. Tout d'abord, la question est de savoir
s'il faut ou non utiliser perl. Dans le premier cas (supposé dans ce document), il y a encore le choix entre deux
types complètement différents d'interface. Si nous n'employons pas perl, il reste la solution d'employer le langage
de script propre à msql, appelé Lite, qui est relativement proche du langage C, en plus simple.</P>
<P></P>
<H3>DBI et DBD-mSQL</H3>
<P>Au moment de la rédaction de ce document, c'est l'utilisation de l'interface générique de base de données appelée DBI
qui est préférée. DBI a quelques avantages. Elle fournit un contrôle d'accès standard à de nombreuses base de données
commerciales, et ce avec le même ensemble de commandes. La base de données en fonctionnement sur un système donné est
alors interrogée par une interface qui masque efficacement les caractéristiques spécifiques de cette base au
programmeur. Ainsi, DBI fournit une passerelle pratique pour travailler avec différentes bases de différents auteurs. Avec
un seul script, il est possible de communiquer avec plusieurs bases de données différentes. Le lecteur interessé peut
consulter la DBI-FAQ pour plus de détails. Il y a cependant un inconvénient : l'interface DBI est en cours de développement
et aligne les versions à une allure galopante (quelques fois avec plusieurs mises à jour par mois). De même, les pilotes
de bases de données sont fréquemment mis à jour, et peuvent être basés sur des versions spécifiques de l'interface de
base de données. Les utilisateurs faisant une première installation doivent se limiter aux numéros de version donnés
dans ce document, car d'autres versions peuvent poser des problèmes de compilation et de test, dont la résolution n'est
pas une affaire de néophyte.</P>
<P></P>
<H3>MsqlPerl</H3>
<P></P>
<P>MsqlPerl est une bibliothèque permettant l'accès direct à msql à partir de programmes écrits en perl. Elle n'utilise pas
l'interface DBI et est très compacte. Bien qu'elle fonctionne très bien avec les deux versions de msql, son usage n'est
pas conseillé par rapport à l'interface DBI, qui tend à se généraliser. Néanmoins, suivant le système, c'est une
alternative intéressante, car la bibliothèque est petite et facile à installer. Notamment, il y a moins de dépendance
par rapport aux numéros de version que celles constatées entre DBI et les pilotes de base de données.</P>
<P></P>
<H3>Le langage de commande propre de msql : Lite</H3>
<P>Enfin, msql-2 fournit son propre langage de commande : Lite. Ce langage est proche du C, assaini et complété avec
quelques fonctionnalités du type 'shell' (d'une certaine manière, c'est une version spécialisée de perl). Lite est
un langage simple et bien documenté dans le manuel msql-2. Le paquetage msql-2 livre aussi en exemple un application
utilisant Lite.</P>
<P>Nous ne décrirons pas ici Lite, car il est trop spécifique de msql-2 (et déjà documenté !), et parce que le lecteur
est censé avoir un certain intérêt pour perl, et en avoir de bonnes notions. Néanmoins, il est recommandé d'y jeter
un coup d'oeil : il peut s'avérer la solution idéale dans un environnement ne mettant en oeuvre que msql-2 (en
supposant donc qu'aucune autre base n'est utilisée), grâce à sa simplicité.</P>
<P></P>
<H2>3.9 <A NAME="ss3.9"></A> La solution standard : DBI et DBD-msql</H2>
<P>Nous supposons que perl a été installé pendant la configuration du système, ou en utilisant le gestionnaire de paquetage
mentionné plus haut. Aucun détail supplémentaire ne sera donné ici. Néanmoins, nous allons d'abord tester si notre
version de perl est récente :</P>
<P>
<PRE>
# perl -v
</PRE>
</P>
<P>perl doit répondre avec le message suivant :</P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
This is perl, version 5.003 with EMBED
Locally applied patches:
SUIDBUF - Buffer overflow fixes for suidperl security
built under linux at Apr 22 1997 10:04:46
+ two suidperl security patches
Copyright 1987-1996, Larry Wall
[...]
</PRE>
</CODE></BLOCKQUOTE>
</P>
<P>Jusque là, tout va bien. L'étape suivante consiste à installer les bibliothèques générales perl pour les bases de
données (DBI), le pilote msql (DBD-mSQL) et CGI. Le pilote CGI est nécessaire dans tous les cas. Les archives
suivantes sont utilisées :</P>
<P>
<OL>
<LI>DBI-0.8.1.tar.gz</LI>
<LI>DBD-mSQL-0.65.tar.gz</LI>
<LI>CGI.pm-2.31.tar.gz (ou plus récent></LI>
</OL>
</P>
<P></P>
<P>Une précision est nécessaire ici pour les débutants : le test décrit ici fonctionne très bien à condition d'utiliser
<EM>exactement</EM> les versions recommandées de logiciels ; des combinaisons d'autres versions peuvent échouer à un moment
ou à un autre. Le déboguage de combinaisons de versions incompatibles est une affaire de spécialistes des interfaces
d'appel. Quelquefois, seule une méthode change de nom alors qu'elle fait la même chose, mais d'autres fois, les
structures internes changent de manière significative. Donc, encore une fois, tenez-vous en aux numéros indiqués de versions
si vous ne voulez pas de problème, et ce même si vous constatez que les versions ont encore changé dans
l'intervalle. Il est normal de voir les versions évoluer rapidement, et vous devez vous attendre à des problèmes en
installant d'autres versions que celles conseillées ici.</P>
<P></P>
<P>Il est très important que le pilote de base pour mSQL (DBD-mSQL) soit installé <EM>après</EM> l'interface générique DBI.</P>
<P></P>
<P>Nous commençons par créer le répertoire <EM>/usr/local/PerlModules</EM> car il est important de conserver l'arborescence
initiale de perl intacte. Nous pourrions aussi choisir un autre nom de répertoire ; cela n'a strictement aucune
importance, malheureusement aucune recommandation n'est faite dans les fichiers README des différents modules perl. Une
fois recopiées les archives précédemment citées dans <CODE>/usr/local/PerlModules</CODE>, nous les décompactons en tapant </P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
# tar zxvf [archive-file]
</PRE>
</CODE></BLOCKQUOTE>
</P>
<P>pour chacune des trois archives. N'oubliez pas d'indiquer le vrai nom de l'archive à la commande <CODE>tar</CODE>. Le processus
d'installation de ces trois archives est très standard ; seuls les messages de sortie concernant les étapes les plus
importantes sont reproduits ici.</P>
<P></P>
<H3>Installation de l'interface perl de base de données DBI</H3>
<P>L'interface de la base de données doit avoir été installée avant le pilote spécifique à la base. Le décompactage de
l'archive DBI crée le répertoire <CODE>/usr/local/PerlModules/DBI-0.81/</CODE>. Placez-vous dans ce répertoire. Il y a un
fichier <CODE>README</CODE> (que vous devriez lire) et un makefile spécifique pour perl. Maintenant, tapez la commande</P>
<P>
<PRE>
# perl Makefile.PL
</PRE>
</P>
<P>Le système doit répondre avec un long message dont la partie la plus importante figure ci-dessous :</P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
[...]
MakeMake (v5.34)
Checking if your kit is complete ...
Looks good
NAME => q[DBI]
PREREQ_PM => { }
VERSION_FROM => q[DBI.pm]
clean => { FILES=>q[$(DISTVNAME) /] }
dist => { DIST_DEFAULT=>q[clean distneck disttest [...]
Using PERL=/usr/bin/perl
WARNING! By default new modules are installed into your 'site_lib' directories. Since site_lib directories
come after the normal library directories you MUST delete old DBI files and directories from your 'privlib'
and 'archlib' directories and their subdirectories.
Writing Makefile for DBI
</PRE>
</CODE></BLOCKQUOTE>
</P>
<P>Comme le programme l'indique, tout va bien, et nous pouvons poursuivre avec l'étape suivante :</P>
<P>
<PRE>
# make
</PRE>
</P>
<P>Si aucun message d'erreur n'apparaît (les traces détaillées affichées sur l'écran <EM>ne</EM> sont <EM>pas</EM> un message
d'erreur), nous pouvons tester la librairie nouvellement installée avec la commande</P>
<P>
<PRE>
# make test
</PRE>
</P>
<P>Sur l'affichage, guettez les lignes suivantes (vous pouvez toujours revenir en arrière avec la touche
<CODE>[Shift]-[PgUp]</CODE>) :</P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
[...]
t/basics............ok
t/dbidrv............ok
t/examp.............ok
All tests successful.
[...]
DBI test application $Revision: 1.20 $
Switch: DBI-0.81 Switch by Tim Bunce, 0.81
Available Drivers: ExampleP, NullP, Sponge
ExampleP: testing 2 sets of 5 connections:
Connecting... 1 2 3 4 5
Disconnecting...
Connecting... 1 2 3 4 5
Disconnecting...
Made 10 connections in 0 seconds ( 0.00 usr 0.00 sys = 0.00 cpu)
test.pl done
</PRE>
</CODE></BLOCKQUOTE>
</P>
<P>La dernière étape est l'installation de tous les fichiers dans leurs répertoires respectifs. La commande suivante s'en occupe :</P>
<P>
<PRE>
# make install
</PRE>
</P>
<P>Il n'y a plus rien à faire. Si pour quelque raison que se soit, l'installation échoue et que vous vouliez la
recommencer, n'oubliez pas de taper d'abord la commande</P>
<P>
<PRE>
# make realclean
</PRE>
</P>
<P>Cela supprimera toutes les traces laissées par la précédente installation. Vous pouvez aussi supprimer les
fichiers installés en copiant le contenu de l'écran (montré ici abrégé)</P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
Installing /usr/lib/perl5/site_perl/i386-linux/./auto/DBI/DBIXS.h
Installing /usr/lib/perl5/site_perl/i386-linux/./auto/DBI/DBI.so
Installing /usr/lib/perl5/site_perl/i386-linux/./auto/DBI/DBI.bs
[...]
Writing /usr/lib/perl5/site_perl/i386-linux/auto/DBI/.packlist
Appending installation info to /usr/lib/perl5/i386-linux/5.003/perllocal.po
</PRE>
</CODE></BLOCKQUOTE>
</P>
<P>dans un fichier, en remplaçant <CODE>Installing</CODE> par <CODE>rm</CODE>. Si vous avez appellé ce fichier <CODE>uninstall</CODE> vous
pouvez alors taper</P>
<P>
<PRE>
# . uninstall
</PRE>
</P>
<P>ce qui effacera les derniers fichiers installés.</P>
<P></P>
<H3>Le pilote msql de perl : DBD-mSQL</H3>
<P>Le pilote msql pourra être installé seulement <EM>après</EM>l'installation réussie de l'interface perl générique de
base de données.</P>
<P></P>
<P>Les étapes de l'installation sont pratiquement les mêmes que les précédentes, donc commencez par taper</P>
<P>
<PRE>
# perl Makefile.PL
</PRE>
</P>
<P>Là, le système doit répondre avec un avertissement vous demandant de lire la documentation accompagnant le logiciel.
Ensuite, il va détecter où se trouve msql, et vous demande quelle version vous utilisez :</P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
$MSQL_HOME not defined. Searching for mSQL...
Using mSQL in /usr/local/Hughes
-> Which version of mSQL are you using [1/2]?
</PRE>
</CODE></BLOCKQUOTE>
</P>
<P>Entrez la version correcte. Quelques lignes de texte suivent. Guettez les suivantes :</P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
Splendid! Your mSQL daemon is running. We can auto-detect your configuration.
I've auto-detected your configuration to be running on port: 1114
</PRE>
</CODE></BLOCKQUOTE>
</P>
<P>Vous pouvez maintenant tester le pilote en tapant</P>
<P>
<PRE>
# make test
</PRE>
</P>
<P>Encore une fois, plusieurs lignes sont affichées. Si elles se terminent par</P>
<P>
<BLOCKQUOTE><CODE>
<PRE>
Testing: $cursor->func( '_ListSelectedFields' )/ This will fail.
ok: not a SELECT in msqlListSelectedFields!
Re-testing: $dbh->do( 'DROP TABLE testaa' )
ok
*** Testing of DBD::mSQL complete! You appear to be normal! ***
</PRE>
</CODE></BLOCKQUOTE>
</P>
<P>tout va bien, et vous pouvez lancer l'installation du pilote en tapant</P>
<P>
<PRE>
# make install
</PRE>
</P>
<P>Vous êtes prêt à continuer et pouvez sauter le paragraphe suivant.</P>
<P></P>
<H2>3.10 <A NAME="ss3.10"></A> L'interface MsqlPerl</H2>
<P>Si vous décidez d'utiliser l'interface globale MsqlPerl, aucun pilote particulier n'est nécessaire ; seule l'archive
<CODE>MsqlPerl-1.15.tar.gz</CODE> est utilisée, puisque, comme cela a déjà été dit, MsqlPerl fournit une interface directe
entre perl et le serveur de base de données, sans utiliser l'interface DBI. L'installation et le test sont très faciles.</P>
<P></P>
<P>Après avoir tapé <CODE>perl Makefile.PL</CODE>, l'utilitaire make peut être activé. Vous devez d'abord indiquer où se trouve
mSQL. S'il est dans <CODE>/usr/local/Minerva/</CODE>, la réponse par défaut peut être validée.</P>
<P></P>
<P>Ensuite, tapez <CODE>make test</CODE>. Avant cela, vous devez vous assurer qu'il y a bien une base nommée <CODE>test</CODE> et que vous
avez les droits d'écriture et lecture dessus. Cela peut être fait avec</P>
<P>
<PRE>
# msqladmin create test
</PRE>
</P>
<P></P>
<H2>3.11 <A NAME="ss3.11"></A> Bibliothèque CGI de perl</H2>
<P>L'installation de l'interface CGI de perl est la plus simple des trois étapes. Lancez les commandes dans l'ordre donné, et voilà :</P>
<P>
<PRE>
# perl Makefile.PL
# make
# make install
</PRE>
</P>
<P>Contrairement aux autres pilotes, cette interface n'a pas d'option de test (<CODE># make test</CODE>), alors que les autres
modules <EM>doivent</EM> être testés dans tous les cas.</P>
<P></P>
<P>Un sous-répertoire avec les exemples CGI est créé. Vous pouvez en copier le contenu vers <CODE>/home/httpd/cgi-bin/</CODE> et
utiliser un navigateur pour jouer avec les scripts.</P>
<P></P>
<H2>3.12 <A NAME="ss3.12"></A> Check-list de l'installation</H2>
<P>
Nous avons effectué les étapes suivantes, dans cet ordre:</P>
<P>
<OL>
<LI>Installation de Linux avec support réseau</LI>
<LI>Installation d'un serveur http, par exemple Apache</LI>
<LI>Installation d'un navigateur, par exemple Arena, Lynx ou Netscape</LI>
<LI>Installation d'un serveur SQL, par exemple msql</LI>
<LI>Installation d'une interface perl SQL convenable</LI>
<LI>Installation des fichiers CGI</LI>
</OL>
</P>
<P>A la fin, vous devez faire un peu de ménage. Toutes les arborescences des sources msql et les modules perl peuvent être
détruites sans inconvénient (cependant, vous ne devriez pas détruire les fichiers archives !) puisque les binaires et la
documentation sont maintenant dans des répertoires différents.</P>
<P></P>
<HR>
<P>
Chapitre <A HREF="WWW-mSQL-HOWTO-4.html">suivant</A>,
Chapitre <A HREF="WWW-mSQL-HOWTO-2.html">Précédent</A>
<P>
Table des matières de <A HREF="WWW-mSQL-HOWTO.html#toc3">ce chapitre</A>,
<A HREF="WWW-mSQL-HOWTO.html#toc">Table des matières</A> générale</P>
<P>
<A HREF="WWW-mSQL-HOWTO.html">Début</A> du document,
<A HREF="#0"> Début de ce chapitre</A></P>
</BODY>
</HTML>
