Installation de base du logiciel APACHE sous Windows Ce chapitre traite l installation du logiciel APACHE à utiliser avec ABCD sous l environment Windows. Au moins Windows NT, Windows 2000 ou les versions supérieures sont supposées installées sur l ordinateur. ABCD fonctionne avec APACHE version 2.2. Comment avoir le logiciel? Le serveur web APACHE peut être téléchargé gratuitement du site web de APACHE: http://www.apache.org/. Installation de APACHE L installation de APACHE sous Windows se fait par l exécution d un «installateur». Si vous vous sentez ne pas être assez expérimenté avec ce type de logiciel, il est recommandé d accepter les paramètres par défaut lors de l installation. Double-cliquez sur l installateur APACHE et suivez les instructions fournies. Ce qui peut produire la configuration suivante sur votre ordinateur (les noms de répertoires pouvant légèrement varier) : Le programme APACHE sera installé dans C:\PROGRAM FILES\APACHE GROUP\APACHE\ Sauf indications contraires, APACHE sera installé comme un service Windows automatique. Ce service peut être également activé ou configuré manuellement : Démarrer > Programmes > Apache HTTP Server > Les répertoires importants lors de l installation sont les suivants: a) C:\PROGRAM FILES\APACHE GROUP\APACHE\htdocs, contient les pages à laisser disponibles pour les visiteurs b) C:\PROGRAM FILES\APACHE GROUP\APACHE\conf, contient le fichier httpd.conf, un fichier définissant les paramètres de configuration du serveur. c) C:\PROGRAM FILES\APACHE GROUP\APACHE\cgi-bin, contient les programmes exécutables qui peuvent accéder à d autres programmes et données. Principalement, la procédure de configuration consiste à l édition du fichier httpd.conf, suppression/addition/édition des lignes. Avant d entreprendre une quelconque modification de la configuration, vérifiez que le Serveur web fonctionne correctement. Si APACHE a été réellement installé, l URL http://localhost/ montrerait une page qui montre que le serveur fonctionne avec un message tel que : 'IT WORKS!'.
Installation de base de PHP sous Windows Ce chapitre traite l installation de PHP à utiliser avec ABCD sous Windows versions NT, 2000 ou supérieures. Comment avoir le logiciel? La version la plus récente est disponible sur le site http://www.php.net/.! Attention: Il y a deux versions de PHP pour Windows: celle qui fonctionne seulement comme une application CGI, et celle qui peut être installée comme un module. Nous vous recommandons d utiliser cette dernière option quand l application aura à traiter beaucoup de données. Installation de PHP Sous Windows, l installation de PHP est tout à fait simple. Il suffit de décompresser (unzip) le fichier compressé dans un répertoire et les copier dans les (sous-)répertoires qui seront utilisés par le système. Nous allons présenter les étapes de l installation PHP ajusté à ABCD. a) créer un répertoire php dans la racine du disque: c:\php ou de votre installation ABCD C:\ABCD\php; b) extraire l archive avec les composantes de PHP vers le répertoire créé dans l étape (a); c) copier les fichiers DLL du répertoire c:\php\dlls\*.dll, dans les répertoires d extension du systeme (généralement WINDOWS\SYSTEM32 ou WINNT\SYSTEM32). En fait, seuls les fichiers DLL qui manipulent les documents XML sont nécessaires, mais il est toujours prudent de préparer l installation pour des changements ultérieurs. Dans tous les cas, les fichiers non utilisés n affectent pas le système et sont contrôlés à partir de la configuration PHP (php.ini); d) utiliser le fichier php.ini-dist comme point de départ de la configuration PHP. Voir la section Configuration de PHP ; e) sauvegarder le fichier créé à l'étape (d) sous le nom php.ini dans le répertoire de Windows (C:\WINNT ou C:\WINDOWS); f) configurer Apache pour fonctionner avec les pages écrites avec PHP. Configuration de PHP Principalement, la procédure consiste à éditer le fichier php.ini-dist, ajuster quelques paramètres et sauvegarder le fichier comme php.ini dans le répertoire Windows. Prendre une copie du fichier c:\php\php.ini-dist en le sauvegardant comme c:\windows\php.ini; Éditer le fichier c:\windows\php.ini (e.g. en utilisant NOTEPAD) et ajuster les paramètres suivants (identifier les lignes correctes avec la fonction de recherche dans le document): extension_dir = "c:\php\ext" extension=php_gd2.dll extension=php_xmlrpc.dll extension=php_xsl.dll
extension=php_yaz.dll Remarques: Les extensions mysql et gd sont les seules nécessaires pour EMPWEB; L extension yaz peut être présente dans le package, voir les instructions spécifiques pour cette installation. Apache avec PHP Avant de commmencer la configuration, vérifier que le Serveur Web fonctionne correctement. Utiliser seulememt votre explorateur Internet et allez à votre site web. Si l installation de APACHE a été réussie, l URL http://localhost/ afficherait une page indiquant que le serveur est en fonction ('IT WORKS! ). La configuration de APACHE se fait en éditant le fichier httpd.conf qui doit se trouver dans le fichier <path_to_apache>\conf\, e.g.: C:\APACHE\conf\. Éditer ce fichier avec un éditeur de texte (e.g. NOTEPAD) et ajouter les lignes qui permettront APACHE de gérer les programmes PHP. Le fichier de configuration est structuré en sections. Vérifier si les lignes ajoutées sont dans la section adéquate. Comme il a été déjà mentionné, PHP peut s exécuter comme CGI ou comme un module APACHE (et non les deux en même temps). La principale difference c est que la seconde option a une meilleure approche pour les traitements des données volumineuses. PHP comme un module APACHE Pour cette option, éditer le fichier httpd.conf : 1. Ajouter le module PHP dans la liste des modules de Apache : LoadModule php5_module "c:\php\php5apache2_2.dll LoadModule proxy_module modules/mod_proxy.so LoadModule proxy_http_module modules/mod_proxy_http.so Remarque.: Seuls les modules Proxy sont nécessaires pour EMPWEB. 2. une ligne qui inclut le type de fichier php dans les tables MIME: AddType application/x-httpd-php.php 3. une ligne qui indique le chemin à php.ini: PHPIniDir "\ABCD\php" Vérification de l installation La dernière étape de la configuration de PHP est de vérifier si APACHE traite correctement les scipts PHP. Pour cela, nous créons un nouveau fichier texte info.php. Assurez-vous que ce fichier ait exactement l extension.php et non une autre (par défaut, Windows cache les extensions des fichiers de types connus ). Ce fichier info.php contiendrait en principe une seule et unique ligne: <? phpinfo();?> Sauvegarder ce fichier dans le répertoire configuré par votre serveur web. Dans une configuration standard APACHE, ce répertoire serait htdocs. Réinitialiser le serveur web: Démarrer > Programmess > Apache HTTP Server > Restart Apache Utiliser votre navigateur explorateur pour visiter le lienurl: http://localhost/info.php Cette page montrera les (/ beaucoup d ) informations sur l installation de PHP que vous avez faite.
Configuration de Apache et PHP sous des environnements Linux Ce chapitre traite l installation de APACHE et PHP pour l utilisation de ABCD sous des environnements Linux. Il est supposé que l ordinateur tourne avec un système d exploitation Linux standard, sans interface graphique (optimisée), sans serveur web et sans l option SELinux. Ceci est nécessaire pour garantir que PHP puisse inclure une bibliothèque dynamique de Apache et la charger sans contraintes. Pour permettre la compilation et l installation de tous les logiciels nécessaires, il est souhaitable que l administrateur s assure que toutes les bibliothèques et tous les utilitaires décrits ici soient disponibles. Compilateur PHP ANSI C et iconv Compilateur Apache - ANSI C et Interpréteur Perl5 Exemples de versions testées Apache 2.2.x PHP 5.2.x Tous ces logiciels nécesitent d être compilés. Ils ne seront pas donc installés en utilisant les outils d installation automatique tels que RPM, etc. Les lignes recommandées pour la compilation sont les suivantes: Extraction du code source dans le répertoire de base cd /usr/local/src tar xvfzp apache_2.2.1.tar.gz tar xvfzp php-5.2.11.tar.gz Mise à jour des chemins pour les bibliothèques vi /etc/ld.so.conf Inclure le chemin pour les bibliothèques /usr/local/lib. Avec certaines versions de Linux, le fichier ld.so.conf contient la ligne : include ld.so.conf.d/*.conf Dans ce cas, il est suggéré de créer un fichier contenant la ligne décrite ci-dessus, e.g. : /etc/ld.so.conf.d/bvs.conf contenant /usr/local/lib Configuration et installation de Apache cd apache_2.2.1 Remarque: la ligne de commande présentée ci-dessous consiste en trois lignes de paramètres../configure --prefix=/usr/local/apache\ --enable-rule=shared_core\ --enable-module=so make make install cd.. Démarrer le service Apache Tester la configuration /usr/local/apache/bin/apachectl configtest Démarrer le service /usr/local/apache/bin/apachectl start Vérification de l état de l installation Ouvrir une fenêtre dans le navigateur Internet de votre choix et tester l URL avec l IP du serveur. e.g. http://200.100.1.100/ ou http://127.0.0.1
Le résultat serait une fenêtre avec un message de bon fonctionnement. Configuration et installation de PHP cd php-5.2.11 Configuration des variables LDFLAGS Ce paramètre est nécessaire pour aviser le compilateur GCC comment compiler les codes PHP: export LDFLAGS=-lstdc++ Démarrer la configuration de PHP Remarque: La ligne de commande consiste en plusieurs lignes de paramètres. './configure' '--prefix=/usr/local/php' '--with-apxs2=/usr/local/apache/bin/apxs' '-- with-xsl' '--enable-ftp' '--with-mysql' '--with-gd' '--with-jpeg-dir=/usr/lib' withmod-proxy make make install Edition du fichier httpd.conf vi /usr/local/apache/conf/httpd.conf Vérifier si le module a été ajouté dans la liste des modules (APIs) de Apache selon les exemples suivants: LoadModule php5_module "c:\php\php5apache2_2.dll LoadModule proxy_module modules/mod_proxy.so LoadModule proxy_http_module modules/mod_proxy_http.so Ajouter une ligne pour que PHP reconnaisse le type MIME: AddType application/x-httpd-php.php Edition du fichier de configuration de PHP Certaines versions de PHP créent le fichier php.ini dans un sous-répertoire /usr/local/php/lib ou /usr/local/php/lib/php. Si la version utilisée ne crée pas un tel fichier, copiez le fichier php.ini-dist du répertoire d installation (php-5.2.11) to /usr/local/php/lib avec le nom php.ini. Maintenant, ce fichier a besoin de quelques changements pour activer certains paramètres: vi php.ini extension_dir = "c:\php\ext" extension=php_gd2.dll extension=php_xmlrpc.dll extension=php_xsl.dll extension=php_yaz.dll Redémarrer le service Apache /usr/local/apache/bin/apachectl start
Installation de base de ABCD ETAPES: 1. En cas d installation, extraire le fichier ZIP de ABCD dans la racine. La structure de répertoires suivante sera créée: ABCD htdocs cgi-bin bases temp 2. Configurez votre serveur Web selon la structure de répertoires créée ci-dessus. Utilisez les paramétrages VirtualHost pour votre configuration. Exemple de VirtualHost pour un Serveur web Apache: <VirtualHost *> ServerAdmin serveradmin@bvs.br DocumentRoot "/home/abcd/htdocs" <Directory "/home/abcd/htdocs"> Options Indexes FollowSymLinks MultiViews </Directory> ServerName abcd.test DirectoryIndex index.htm index.php homepage.htm ScriptAlias /cgi-bin/ "/home/abcd/cgi-bin/" <Directory "/home/abcd/cgi-bin/"> AllowOverride None Options None Order allow,deny Allow from all </Directory> </VirtualHost> 2.1. Répertoires à tenir en compte dans la configuration du Serveur Web: htdocs --> répertoire pour les données (document racine) cgi-bin --> répertoire pour l exécution des scripts CGI 3. 3.1. Modifier le fichier de configuration du site ABCD htdocs/site/bvs-site-conf.php Le chemin de SITE_PATH et DATABASE_PATH devrait contenir le chemin d où le paquet serait extrait. Le SERVERNAME indiquerait à l URL configuré dans le Serveur Web. SITE_PATH=/ABCD/www/htdocs/site/ DATABASE_PATH=/ABCD/www/bases/site/ SERVERNAME=localhost Dans le cas d une installation Linux, le paramètre LETTER_UNIT serait commenté avec ";" (pour le désactiver), mais pour une installation Windows, cette ligne devrait être activée pour indiquer l unité disque (surtout la partition de disque dur). ;LETTER_UNIT=D: 3.2. Modifier le fichier de configuration de iah htdocs/iah/scripts/iah.def.php Le chemin pour les paramètres PATH_CGI-BIN, PATH_DATABASE et PATH_DEF seraient ajustés vers le chemin d extraction du paquet d installation.
PATH_CGI-BIN=/ABCD/www/htdocs/iah/scripts/ PATH_DATABASE=/ABCD/www/bases/ PATH_DEF=/ABCD/www/bases/par/ 3.3. Modifier le fichier de configuration de ABCD-Central htdocs/central/config.php Les chemins pour les variables $db_path, $Wxis et $xwxis se référeraient au chemin d extraction du paquet d installation. $db_path="/abcd/www/bases/"; $Wxis="/ABCD/www/cgi-bin/wxis.exe"; $xwxis="/abcd/www/htdocs/$app_path/dataentry/wxis/"; Pour utiliser le protocole de CGI-BIN au lieu de 'exec' directement, dans l utilisation de wxis serveur ISIS, il est nécessaire de configurer aussi le paramètre $wxisurl, où le URL de ce fichier exécutable a besoin d être identifié. $wxisurl="http://localhost:9090/cgi-bin/wxis.exe"; En cas de problèmes lors du changement de ces fichiers de configuration, il est possible de restaurer les fichiers originaux à partir des fichiers.template, qui sont dans les répertoires correspondant à chaque fichier de configuration. 4. Changer les droits d accès (très important en Linux) selon les instructions suivantes: 775 Recursive for cgi-bin and htdocs 777 Recursive for bases and temp 5. Ouvrir l URL de ABCD Central directement à partir du lien, e.g.: http://abcd.test/ 6. Ouvrir l URL du site ABCD, en ajoutant /site, e.g.: http://abcd.test/site/ 7. Ouvrir l URL de ABCD SeCS-Web, en ajoutant /secs-web, par exemple: http://abcd.test/secs-web/ Information complémentaire Lors de l installation de yaz (pour la fonctionnalité Z39.50), il se peut que certains problèmes surgissent. Il est recommandé de verifier les instructions y afférantes qui sont diponibles dans des fichiers dédiés sur le site web de BVS-Modelo. Malheureusement, de telles instructions ne sont pas encore disponibles pour Linux. Un manuel d utilisation est également disponible pour l installation de EmpWeb.