Serveur Apache HTTP Version 2.1
Serveur Apache HTTP Version 2.1
Ce document couvre la compilation et l'installation d'Apache sur les syst�mes Unix et clones d'Unix. Pour la compilation et l'installation sous Windows, voir Utiliser Apache sous Windows . Pour les autres plate-formes, voir la documentation des plate-formes.
L'environnement de configuration et d'installation d'Apache 2.0 a �t�
compl�tement revu par rapport � celui d'Apache 1.3. Apache 1.3 utilisait un
ensemble de scripts pour permettre une installation facile. Apache 2.0
utilise � pr�sent libtool et autoconf afin de
cr�er un environnement le plus proche possible d'autres projets � Code
Source Libre.
Si vous faite une mise � niveau d'une version mineur � la suivante (par exemple, 2.0.50 � 2.0.51), veuillez s'il vous pla�t sauter directement � la section Mise � niveau.
Survol Rapide pour les
impatients Pr�-requis T�l�charger Extraire Configurer l'arboresecence source Compiler Installer Personnaliser la Configuration Tester Mise � niveau
| T�l�charger | $ lynx http://httpd.apache.org/download.cgi
|
| Extraire | $ gzip -d httpd-2_1_NN.tar.gz |
| Configurer | $ ./configure --prefix=PREFIX
|
| Compiler | $ make |
| Installer | $ make install |
| Personnaliser | $ vi PREFIX/conf/httpd.conf |
| Tester | $ PREFIX/bin/apachectl start
|
NN doit �tre remplac� par le num�ro de version mineur actuel, et
PREFIX par le chemin o� le serveur doit �tre install�. Si
PREFIX n'est pas sp�cifi�, l'installation se fait dans
/usr/local/apache2.
Chacune des sections du processus de compilation et d'installation est d�crite ci-apr�s, en commen�ant par les pr�-requis � la compilation et � l'installation d'Apache HTTPD.
Les pr�-requis suivants sont n�cessaire pour l'installation d'Apache:
make, doivent �tre pr�sent dans votre
PATH.ntpdate ou xntpd sont
utilis�s; ces programmes impl�mentent le Network Time Protocol (NTP).
Voir le groupe Usenet comp.protocols.time.ntp et la page NTP pour plus de d�tails
sur les logiciels NTP et les serveurs de temps publics.configure ne trouve pas d'interpr�teur
Perl, la compilation sera quand m�me r�alis�e sans soucis. Seuls ces
scripts ne seront pas utilisables. Si plusieurs interpr�teurs Perl sont
install�s (par exemple, Perl 4 fourni avec l'OS, et Perl 5 install� par
l'administrateur), il est conseill� de passer l'option
--with-perl afin de garantir que le bon interpr�teur est
utilis� par ./configure.Apache est t�l�chargeable depuis le site de t�l�chargement
d'Apache qui fournit la liste de plusieurs miroirs. L� sont disponibles
les derni�res versions. La plupart des
utilisateurs d'Apache sur des syst�mes de type Unix devraient
probablement t�l�charger et compiler une version de la source.
Le processus de construction (d�crit ci-dessous) est facile, et
vous permet d'adapter votre serveur pour convenir � vos besoins.
En outre, les versions binaires ne sont souvent pas � jour avec
les derni�res versions du code source. Si vous t�l�chargez une
version binaire, suivez les instructions dans le dossier
INSTALL.bindist � l'int�rieur de la distribution.
Apr�s le t�l�chargement, il est important de v�rifier que les sources
t�l�charg�es sont bien compl�tes et non modifi�es, et ce surtout si un
miroir a �t� utilis� pour le t�l�chargement. Ceci peut �tre fait en
testant l'archive tar t�l�charg�e avec la signature PGP. Cette proc�dure
s'effectue en 2 �tapes. D'abord, il faut r�cup�rer le fichier KEYS du site
de distribution d'Apache. (Pour v�rifier que ce fichier KEYS
n'a pas �t� modifi�, une bonne id�e peut �tre d'utiliser un fichier d'une
distribution pr�c�dente d'Apache, ou d'importer les cl�s d'un serveur de
cl�s public.) Les cl�s peuvent �tre import�es dans le keyring de
l'utilisateur au moyen d'une des commandes (selon la version de PGP):
$ pgp < KEYS
ou
$ gpg --import KEYS
La prochaine �tape est de tester l'archive tar au moyen de la signature
PGP, qui devrait toujours �tre disponible sur le site principal d'Apache.
Un lien vers cette signature est plac� derri�re le lien de t�l�chargement
correspondant ou peut �tre trouv� dans le r�pertoire correspondant sur le site de distribution
d'Apache. Le nom de ce fichier est le m�me que celui de l'archive
source, avec en plus l'extension .asc. La distribution
t�l�charg�e peut alors �tre v�rifi�e au moyen de la commande (� nouveau,
selon la version de PGP):
$ pgp httpd-2_1_NN.tar.gz.asc
ou
$ gpg --verify httpd-2_1_NN.tar.gz.asc
Un message comme celui-ci devrait s'afficher
Good signature from user "Martin Kraemer
<[email protected]>".
Selon les relations de confiances contenues dans le keyring de
l'utilisateur, un message peut s'afficher, sp�cifiant que la relation entre
la cl� et le signataire ne peut �tre v�rifi�e. Ceci n'est pas un probl�me si
vous ne mettez pas en doute l'authenticit� du fichier KEYS.
Extraire les sources � partir de l'archive tar est une simple affaire de d�compression et d�tarrage:
$ gzip -d httpd-2_1_NN.tar.gz
$ tar xvf httpd-2_1_NN.tar
Un nouveau r�pertoire est cr�� dans le r�pertoire courant, il contient le
code source de la distribution. Il faut entrer dans ce r�pertoire au moyen
de la commande cd avant de commencer la compilation du
serveur.
L'�tape suivante est la configuration de l'arborescence source d'Apache,
pour votre plate-forme et selon les n�cessit�s du site. Cette configuration est
r�alis�e au moyen du script configure fournit dans le
r�pertoire racine de la distribution. (Les d�veloppeurs qui t�l�chargent
Apache via CVS devront utiliser les outils autoconf et
libtool avant de proc�der � la suite. Ceci n'est pas n�cessaire
pour les versions officielles.)
Pour configurer l'arborscence source en utilisant les options par
d�faut taper ./configure. Pour modifier les valeurs des
options par d�faut, configure accepte un grand nombre de
variables et d'options de ligne de commande.
La plus importante de ces options est le pr�fixe o� Apache sera install�, car Apache doit �tre configur� pour que cet emplacement fonctionne correctement. Plusieurs autres options sont disponibles pour le contr�le fin de l'emplacement des fichiers resultants avec options de configuration.
En outre � ce moment, vous pouvez indiquer quels fonctionalit�s
vous voulez inclure dans Apache en ajoutant et/ou en retranchant
des modules. Apache vient avec un ensemble
de modules de Base
inclus par d�faut. D'autres modules peuvent �tre ajout�s en utilisant
l'option --enable-module, o�
module est le nom du module avec la cha�ne
mod_ coup�e et avec les caract�res de soulignement
converti en un tiret. Vous pouvez �galement choisir de compiler
des modules en tant qu'objets partag�s (DSOs),
qui peuvent �tre charg�s ou d�charg� � l'ex�cution -- en employant
l'option --enable-module=shared.
De m�me, vous pouvez retrancher les modules de Base avec l'option
--disable-module. Prenez garde lorsque
vous employer ces options, puisque configure ne peut
vous informer si le module cible n'existe pas; configure
ignorera simplement l'option.
Il est parfois n�cessaire de fournir des
informations suppl�mentaires au script
configure sur l'emplacement de votre
compilateur, biblioth�ques, ou dossiers d'en-t�te. Ceci se fait en
passant les variables d'environnement ou des options inclus sur la ligne
de commande � configure. Pour plus d'information
sur ce sujet, consultez la page de documentation
configurer.
L'exemple suivant compile Apache pour �tre install�
dans /sw/pkg/apache avec un
compilateur et des drapeaux de compilation particuliers, ainsi que les deux
modules mod_rewrite et mod_speling, qui
pourront �tre charg�s plus tard au moyen des m�canismes DSO:
$ CC="pgcc" CFLAGS="-O2" \
./configure --prefix=/sw/pkg/apache \
--enable-rewrite=shared \
--enable-speling=shared
Une fois lanc�, configure, peut prendre quelques minutes
pour tester les possibilit�s du syst�me et construire les fichiers
Makefile qui seront utilis�s pour construire le serveur.
Les d�tails sur toutes les diff�rentes options configure sont
disponibles sur la page de documentation configurer.
Les diff�rents composants d'Apache sont � pr�sent pr�tes � �tre compil�s, en tapant simplement la commande:
$ make
Un peu de patience est demand�e, une configuration standard met environ 3 minutes � se compiler sur un Pentium III sous Linux 2.2. Ce temps peut varier largement, suivant le mat�riel utilis�, et les modules selectionn�s.
Il est temps d'installer le 'package' dans le r�pertoire d'installation
PREFIX configur� auparavant (voir l'option --prefix
ci-dessus) en tapant:
$ make install
En cas de mise � jour, l'installation n'ecrasera ni les fichiers de configuration du serveur, ni ses documents.
Il reste � pr�sent � configurer le serveur HTTP Apache, en �ditant les
fichiers de configuration plac�s dans
PREFIX/conf/.
$ vi PREFIX/conf/httpd.conf
A consulter : le manuel d'Apache dans docs/manual/ ou bien http://httpd.apache.org/docs-2.1/ pour la derni�re version de ce manuel, ainsi qu'une r�f�rence compl�te de toutes les directives de configuration.
Une fois configur�, le serveur HTTP Apache peut �tre d�marr� en tapant:
$ PREFIX/bin/apachectl start
puis vous devriez pouvoir tester l'URL http://localhost/.
La page affich�e est plac�e dans le r�pertoire
DocumentRoot, habituellement configur�
en tant que PREFIX/htdocs/.
Le serveur peut �tre arr�t� en tapant:
$ PREFIX/bin/apachectl stop
La premi�re �tape pour la mise � niveau est de lire
l'annonce de la nouvelle version et le fichier CHANGES
dans la distribution afin de trouver tous les changements qui
peuvent affecter votre site. Si la mise � jour est effectu�e
entre deux version principales (par exemple, de 1.3 � 2.0 ou
de 2.0 � 2.2), attendez-vous � des diff�rences majeurs
au moment de la compilation et de l'ex�cution exigeant probablement
des ajustements manuels. Tous les modules devront �galement
�tre mis � niveaux pour tenir compte des changements � l'API.
La mise � jour d'une version mineure � une plus r�cente
(par exemple, de 2.0.55 � 2.0.57) est plus facile. Le processus
make install n'�crasera aucun de vos documents
, fichiers journaux, ou fichiers de configuration existants.
En outre, les d�veloppeurs font tout les efforts possibles
effort d'�viter les changements incompatibles des options
configure, de la configuration d'ex�cution,
ou de l'API entre les versions mineures. Dans la plupart
des cas vous devriez pouvoir employer une ligne de commande
configure et un fichier de configuration
identiques. De plus, tous vos modules devraient continuer � fonctionner.
(C'est seulement valide pour les versions post�rieures � 2.0.41;
les versions ant�rieures ont des changements incompatibles.)
Si vous avez gard� l'arborescence source de votre derni�re
installation, la mise � niveau est encore plus facile.
Le dossier config.nice dans la racine de l'ancienne
arborescence contient la ligne de commande configure
exacte que vous avez utilis� pour configurer l'arborescence de
la source. Pour faire la mise � niveau d'une version � la suivante
, vous devez copier le dossier config.nice �
l'arborescence de source de la nouvelle version, l'�ditez
pour faire les changements d�sir�s, puis ex�cutez:
$ ./config.nice
$ make
$ make install
$ PREFIX/bin/apachectl stop
$ PREFIX/bin/apachectl start
--prefix et un port diff�rent
(possible en ajustant la directive Listen)
dans le but de tester toutes les incompatibilit�s possible avant de
faire la mise � niveau finale.