Instalao simples do APACHE em ambientes Windows

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_mysql.dll
extension=php_mysql.dll
extension=php_mysql.dll
extension=php_mysql.dll
extension=php_mysql.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_mysql.dll
extension=php_mysql.dll
extension=php_mysql.dll
extension=php_mysql.dll
extension=php_mysql.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 [email protected]
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.