Compilation et installation

AperÃu pour les plus pressÈs

NN doit Étre remplacÈ par le numÈro de version courant, et PREFIX par le chemin du rÈpertoire d'installation. Si PREFIX n'est pas spÈcifiÈ, le chemin du rÈpertoire d'installation prendra sa valeur par dÈfaut, Þ savoir /usr/local/apache2.

Chaque Ètape du processus de compilation et d'installation est dÈcrite plus en dÈtails ci-dessous, Þ commencer par les prÈrequis pour compiler et installer le serveur HTTP Apache.

PrÈrequis

Les prÈrequis pour la construction d'Apache HTTPd sont les suivants:

Espace disque

Assurez-vous d'avoir au moins 50 MB d'espace disque disponible temporaire. AprÕs l'installation Apache occupe approximativement 10 MB d'espace disque. L'espace disque rÈellement nÈcessaire va varier considÈrablement en fonction de vos options de configuration et de la prÈsence Èventuelle de modules tiers.

Compilateur ANSI-C et systÕme de construction

Vous devez disposer d'un compilateur ANSI-C. Le compilateur GNU C (GCC) de la Free Software Foundation (FSF) est recommandÈ. Si vous ne possÈdez pas GCC, assurez-vous au moins que votre compilateur soit compatible ANSI. En outre, votre PATH doit contenir les outils de construction de base tels que make.

Connaissance de l'heure exacte

Les ÈlÈments du protocole HTTP font rÈfÈrence Þ l'heure du jour. Par consÈquent, il est nÈcessaire d'Èquiper votre systÕme d'un dispositif de synchronisation du temps. Les programmes ntpdate ou xntpd, basÈs sur le protocole NTP, sont couramment utilisÈs Þ cet effet. Voir la page d'accueil de NTP pour plus de dÈtails Þ propos du logiciel NTP et des serveurs de temps publics.

Perl 5 [OPTIONNEL]

L'interprÈteur Perl 5 (les versions 5.003 ou supÈrieures conviennent) est nÈcessaire pour l'exÈcution de certains scripts comme apxs ou dbmmanage (qui sont Ècrits en Perl). Si vous disposez de plusieurs interprÈteurs Perl (par exemple, une installation globale Perl 4, et votre installation personnelle de Perl 5), il vous faut utiliser l'option --with-perl (voir ci-dessous) afin de vous assurer que le bon interprÈteur sera utilisÈ par configure. Si le script configure ne trouve pas d'interprÈteur Perl 5, vous ne pourrez pas utiliser les scripts qui en ont besoin. Bien entendu, vous pourrez tout de mÉme construire et utiliser Apache httpd.

apr/apr-util >= 1.2

apr et apr-util sont inclus dans les sources d'Apache HTTPd, et peuvent Étre utilisÈs sans problÕme dans la plupart des cas. Cependant, si apr ou apr-util, versions 1.0 ou 1.1, sont installÈs sur votre systÕme, vous devez soit mettre Þ jour vos installations apr/apr-util vers la version 1.2, forcer l'utilisation des bibliothÕques intÈgrÈes, soit faire en sorte que httpd utilise des constructions sÈparÈes. Pour utiliser les sources de apr/apr-util incluses, utilisez l'option --with-included-apr du script configure :

Note

L'option --with-included-apr est disponible Þ partir de la version 2.2.3

# Forcer l'utilisation des sources de apr/apr-util intÈgrÈes
./configure --with-included-apr


Pour construire Apache HTTPd suite Þ une installation manuelle de apr/apr-util :

# Construction et installation apr 1.2
cd srclib/apr
./configure --prefix=/usr/local/apr-httpd/
make
make install

# Construction et installation apr-util 1.2
cd ../apr-util
./configure --prefix=/usr/local/apr-util-httpd/ --with-apr=/usr/local/apr-httpd/
make
make install

# Configuration httpd
cd ../../
./configure --with-apr=/usr/local/apr-httpd/ --with-apr-util=/usr/local/apr-util-httpd/

TÈlÈchargement

Le serveur HTTP Apache peut Étre tÈlÈchargÈ Þ partir du site de tÈlÈchargement du serveur HTTP Apache, qui fournit la liste de nombreux miroirs. Il sera plus commode Þ la plupart des utilisateurs d'Apache HTTPd sur les systÕmes UNIX ou similaires de tÈlÈcharger et de compiler la version sources. Le processus de construction (dÈcrit ci-dessous) est simple, et vous permet de personnaliser votre serveur selon vos besoins. En outre, les versions binaires sont souvent plus anciennes que les derniÕres versions sources Si vous tÈlÈchargez une version binaire, suivez les instructions dÈcrites dans le fichier INSTALL.bindist inclus dans la distribution.

AprÕs le tÈlÈchargement, il est important de vÈrifier que vous disposez d'une version complÕte et non modifiÈe du serveur HTTP Apache. Vous pouvez le faire en testant l'archive tÈlÈchargÈe Þ l'aide de la signature PGP. Vous trouverez les dÈtails de cette opÈration sur la page de tÈlÈchargement ainsi qu'un exemple prÈcis dÈcrivant l'utilisation de PGP.

Extraction

L'extraction des sources depuis l'archive Apache HTTPd consiste simplement Þ dÈcompresser et Þ dÈsarchiver cette derniÕre :

Ceci crÈera, dans le rÈpertoire courant, un nouveau rÈpertoire contenant le code source de la distribution. Vous devrez vous positionner dans ce rÈpertoire avant de procÈder Þ la compilation du serveur.

Configuration de l'arborescence des sources

L'Ètape suivante consiste Þ configurer l'arborescence des sources d'Apache HTTPd en fonction de votre plateforme et de vos besoins personnels. Le script configure, situÈ Þ la racine du rÈpertoire de la distribution, a ÈtÈ conÃu Þ cet effet. (Les dÈveloppeurs qui tÈlÈchargent une version non officielle de l'arborescence des sources d'Apache HTTPd devront disposer de autoconf et libtool et exÈcuter buildconf avant de passer Þ l'Ètape suivante, ce qui n'est pas nÈcessaire pour les versions officielles.)

Pour configurer l'arborescence des sources avec les valeurs par dÈfaut pour toutes les options, entrez simplement ./configure. Pour modifier les valeurs des options, configure comprend toute une variÈtÈ de variables et d'options de ligne de commande.

L'option la plus importante --prefix est le chemin du rÈpertoire d'installation du serveur HTTP Apache, car Apache doit Étre configurÈ en fonction de ce chemin pour pouvoir fonctionner correctement. Il est possible de dÈfinir plus finement le chemin d'installation des fichiers Þ l'aide d' options supplÈmentaires de configure.

þ ce niveau, vous pouvez aussi spÈcifier de quelles fonctionnalitÈs vous voulez disposer dans Apache HTTPd en activant ou dÈsactivant des modules. Apache est fourni avec un jeu de modules de Base inclus par dÈfaut. Les autres modules sont activÈs Þ l'aide de l'option --enable-module, oÛ module est le nom du module sans la chaÍne mod_ et oÛ tout caractÕre de soulignement est converti en tiret. Vous pouvez aussi choisir de compiler les modules comme objets partagÈs (DSOs) -- qui peuvent Étre chargÈs ou dÈchargÈs Þ l'exÈcution -- Þ l'aide de l'option --enable-module=shared. D'une maniÕre similaire, vous pouvez dÈsactiver des modules de base Þ l'aide de l'option --disable-module option. Faites trÕs attention en utilisant ces options, car configure n'est pas en mesure de vous avertir si le module que vous avez spÈcifiÈ n'existe pas; il ignorera tout simplement l'option.

En outre, vous devrez peut-Étre fournir au script configure des informations supplÈmentaires sur le chemin de votre compilateur, de vos librairies, ou de vos fichiers d'en-tÉtes. A cet effet, vous pouvez passer des options de ligne de commande ou des variables d'environnement au script configure. Pour plus d'informations, voir la page de manuel de configure.

Pour vous faire une idÈe des possibilitÈs qui s'offrent Þ vous, voici un exemple typique de compilation d'Apache avec le rÈpertoire d'installation /sw/pkg/apache, un compilateur et des drapeaux particuliers et les deux modules additionnels mod_rewrite et mod_speling qui pourront Étre chargÈs plus tard Þ l'aide du mÈcanisme DSO:

Quand configure est lancÈ, il peut prendre plusieurs minutes pour tester la disponibilitÈ des fonctionnalitÈs au sein de votre systÕme, et construire les Makefiles qui seront utilisÈs par la suite pour compiler le serveur.

Vous trouverez une description dÈtaillÈe des options de configure dans sa page de manuel.

Construction

Vous pouvez maintenant construire les diffÈrents ÈlÈments qui composent le paquet Apache HTTPd en lanÃant tout simplement la commande :

Vous devez Étre patient, car il faut plusieurs minutes pour compiler une configuration de base, et cette durÈe peut varier considÈrablement en fonction de votre matÈriel et du nombre de modules que vous avez activÈs.

Installation

Il est temps maintenant d'installer le paquet dans le rÈpertoire d'installation dÈfini par PREFIX (voir plus haut l'option --prefix) en lanÃant:

Si vous effectuez une mise Þ jour, l'installation n'Ècrasera pas vos fichiers de configuration ou autres documents.

Personnalisation

Ensuite, vous pourrez personnaliser votre Serveur HTTP Apache en Èditant les fichiers de configuration situÈs dans PREFIX/conf/.

Consultez le manuel du serveur HTTP Apache situÈ dans docs/manual/ ou http://httpd.apache.org/docs/2.2/ pour la version la plus rÈcente de ce manuel et la liste complÕte des directives de configuration disponibles.

Test

Vous pouvez maintenant dÈmarrer votre Serveur HTTP Apache en lanÃant:

Vous devriez alors pouvoir requÈrir votre premier document Þ l'aide de l'URL http://localhost/. La page web que vous voyez est situÈe dans le rÈpertoire dÈfini par la directive DocumentRoot, qui est gÈnÈralement PREFIX/htdocs/. Pour arrÉter le serveur, lancez:

Mise Þ jour

La premiÕre Ètape d'une mise Þ jour consiste Þ lire l'annonce de la sortie de la nouvelle version et le fichier CHANGES dans la distribution des sources afin de dÈceler toutes les modifications qui pourraient affecter votre site. Lors d'un changement majeur de version (par exemple de 1.3 Þ 2.0 ou de 2.0 Þ 2.2), il y aura certainement des diffÈrences importantes quant Þ la configuration de la compilation et de l'exÈcution qui nÈcessiteront des ajustements manuels. Tous les modules devront aussi Étre mis Þ jour pour qu'ils s'adaptent aux changements de l'API des modules.

La mise Þ jour d'une version mineure Þ la suivante (par exemple, de 2.2.55 Þ 2.2.57) est plus aisÈe. Le processus make install n'Ècrasera aucun de vos documents existants, fichiers de log, ou fichiers de configuration. De plus, les dÈveloppeurs font tout leur possible pour Èviter les changements entraÍnant une incompatibilitÈ dans les options de configure, la configuration de l'exÈcution, ou l'API des modules d'une version mineure Þ l'autre. Dans la plupart des cas, vous pourrez utiliser une ligne de commande configure identique, le mÉme fichier de configuration, et tous vos modules continueront de fonctionner.

Pour effectuer une mise Þ jour entre deux versions mineures, commencez par trouver le fichier config.nice dans le rÈpertoire de construction de votre serveur installÈ ou Þ la racine de l'arborescence des sources de votre ancienne installation. Il contient la reproduction exacte de la ligne de commande configure que vous avez utilisÈe pour configurer l'arborescence des sources. Ensuite, pour mettre Þ jour l'ancienne version vers la nouvelle, il vous suffit de copier le fichier config.nice dans l'arborescence des sources de la nouvelle version, de l'Èditer pour effectuer toute modification souhaitÈe, et de lancer: