| <?xml version="1.0" encoding="ISO-8859-1" ?> |
| <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd"> |
| <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?> |
| <!-- French translation : Lucien GENTIS --> |
| <!-- Reviewed by : Vincent Deffontaines --> |
| <!-- English Revision: 527129 --> |
| |
| <!-- |
| Licensed to the Apache Software Foundation (ASF) under one or more |
| contributor license agreements. See the NOTICE file distributed with |
| this work for additional information regarding copyright ownership. |
| The ASF licenses this file to You under the Apache License, Version 2.0 |
| (the "License"); you may not use this file except in compliance with |
| the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, software |
| distributed under the License is distributed on an "AS IS" BASIS, |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| See the License for the specific language governing permissions and |
| limitations under the License. |
| --> |
| |
| <manualpage metafile="install.xml.meta"> |
| |
| <title>Compilation et installation</title> |
| |
| <summary> |
| |
| <p>Ce document couvre l'installation et la compilation d'Apache |
| sur les systèmes Unix et similaires seulement. Pour la compilation et |
| l'installation sous Windows, voir <a |
| href="platform/windows.html">Utiliser Apache avec Microsoft |
| Windows</a>. Pour les autres plateformes, se référer à la documentation par |
| <a href="platform/">plateforme</a>.</p> |
| |
| <p>Apache httpd utilise <code>libtool</code> et <code>autoconf</code> |
| afin de créer un environnement de construction similaire à la plupart |
| des projets Open Source .</p> |
| |
| <p>Si vous effectuez une mise à jour depuis une version mineure vers |
| la suivante (par exemple, 2.2.50 à 2.2.51), veuillez passer à la section |
| <a href="#upgrading">mise à jour</a>.</p> |
| |
| </summary> |
| |
| <seealso><a href="programs/configure.html">Configuration de l'arborescence |
| des sources</a></seealso> |
| <seealso><a href="invoking.html">Démarrer Apache</a></seealso> |
| <seealso><a href="stopping.html">Arrêt et redémarrage</a></seealso> |
| |
| <section id="overview"><title>Aperçu pour les plus pressés</title> |
| |
| <table> |
| <columnspec><column width=".13"/><column width=".80"/></columnspec> |
| <tr> |
| <td><a href="#download">Téléchargement</a></td> |
| |
| <td><code>$ lynx http://httpd.apache.org/download.cgi</code> |
| </td> |
| </tr> |
| |
| <tr> |
| <td><a href="#extract">Extraction</a></td> |
| |
| <td><code>$ gzip -d httpd-<em>NN</em>.tar.gz<br /> |
| $ tar xvf httpd-<em>NN</em>.tar<br /> |
| $ cd httpd-<em>NN</em></code></td> |
| </tr> |
| |
| <tr> |
| <td><a href="#configure">Configuration</a></td> |
| |
| <td><code>$ ./configure --prefix=<em>PREFIX</em></code> |
| </td> |
| </tr> |
| |
| <tr> |
| <td><a href="#compile">Compilation</a></td> |
| |
| <td><code>$ make</code> </td> |
| </tr> |
| |
| <tr> |
| <td><a href="#install">Installation</a></td> |
| |
| <td><code>$ make install</code> </td> |
| </tr> |
| |
| <tr> |
| <td><a href="#customize">Personnalisation</a></td> |
| |
| <td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td> |
| </tr> |
| |
| <tr> |
| <td><a href="#test">Test</a></td> |
| |
| <td><code>$ <em>PREFIX</em>/bin/apachectl -k start</code> |
| </td> |
| </tr> |
| </table> |
| |
| <p><em>NN</em> doit être remplacé par le numéro de version courant, |
| et <em>PREFIX</em> par le |
| chemin du répertoire d'installation. Si |
| <em>PREFIX</em> n'est pas spécifié, le chemin du répertoire |
| d'installation prendra sa valeur par défaut, à savoir |
| <code>/usr/local/apache2</code>.</p> |
| |
| <p>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 Apache httpd.</p> |
| </section> |
| |
| <section id="requirements"><title>Prérequis</title> |
| |
| <p>Les prérequis pour la construction d'Apache sont les suivants:</p> |
| |
| <dl> |
| <dt>Espace disque</dt> |
| <dd>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.</dd> |
| |
| <dt>Compilateur ANSI-C et système de construction</dt> |
| <dd>Vous devez disposer d'un compilateur ANSI-C. Le compilateur <a |
| href="http://www.gnu.org/software/gcc/gcc.html">GNU C |
| (GCC)</a> de la <a |
| href="http://www.gnu.org/">Free Software Foundation (FSF)</a> |
| est recommandé. Si vous ne possédez pas GCC, |
| assurez-vous au moins que votre compilateur soit compatible ANSI. |
| En outre, votre <code>PATH</code> doit contenir |
| les outils de construction de base tels que <code>make</code>.</dd> |
| |
| <dt>Connaissance de l'heure exacte</dt> |
| <dd>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 |
| <code>ntpdate</code> ou <code>xntpd</code>, basés sur le protocole NTP, |
| sont couramment utilisés à cet effet. |
| Voir la <a href="http://www.ntp.org">page d'accueil de NTP</a> |
| pour plus de détails à propos du logiciel NTP et des serveurs |
| de temps publics.</dd> |
| |
| <dt><a href="http://www.perl.org/">Perl 5</a> |
| [OPTIONNEL]</dt> |
| <dd>L'interpréteur Perl 5 (les versions 5.003 ou supérieures conviennent) |
| est nécessaire pour l'exécution de certains scripts comme |
| <program>apxs</program> ou <program>dbmmanage</program> |
| (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 |
| <code>--with-perl</code> (voir ci-dessous) afin de vous assurer que le |
| bon interpréteur sera utilisé par <program>configure</program>. |
| Si le script <program>configure</program> 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.</dd> |
| |
| </dl> |
| </section> |
| |
| <section id="download"><title>Téléchargement</title> |
| |
| <p>Le serveur HTTP Apache peut être téléchargé à partir du |
| <a href="http://httpd.apache.org/download.cgi">site de téléchargement |
| du serveur HTTP Apache</a>, qui fournit la liste de nombreux miroirs. |
| Il sera plus commode à la plupart des utilisateurs d'Apache 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 |
| <code>INSTALL.bindist</code> inclus dans la distribution.</p> |
| |
| <p>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 <a |
| href="http://httpd.apache.org/download.cgi#verify" |
| >page de téléchargement</a> ainsi qu'un exemple précis décrivant <a |
| href="http://httpd.apache.org/dev/verification.html">l'utilisation de |
| PGP</a>.</p> |
| |
| </section> |
| |
| <section id="extract"><title>Extraction</title> |
| |
| <p>L'extraction des sources depuis l'archive Apache HTTPD consiste |
| simplement à décompresser et à désarchiver cette dernière :</p> |
| |
| <example> |
| $ gzip -d httpd-<em>NN</em>.tar.gz<br /> |
| $ tar xvf httpd-<em>NN</em>.tar |
| </example> |
| |
| <p>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.</p> |
| </section> |
| |
| <section id="configure"><title>Configuration de l'arborescence des sources</title> |
| |
| <p>L'étape suivante consiste à configurer l'arborescence des sources |
| d'Apache en fonction de votre plateforme et de vos besoins personnels. |
| Le script <program>configure</program>, 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 |
| devront disposer de |
| <code>autoconf</code> et <code>libtool</code> et |
| exécuter <code>buildconf</code> avant de passer à l'étape suivante, |
| ce qui n'est pas nécessaire pour les versions officielles.)</p> |
| |
| <p>Pour configurer l'arborescence des sources avec les valeurs par défaut |
| pour toutes les options, entrez simplement <code>./configure</code>. |
| Pour modifier les valeurs des options, <program>configure</program> |
| comprend toute une variété de variables et |
| d'options de ligne de commande.</p> |
| |
| <p>L'option la plus importante <code>--prefix</code> est le chemin |
| du répertoire d'installation d'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'<a href="programs/configure.html#installationdirectories"> |
| options supplémentaires de configure</a>.</p> |
| |
| <p>À ce niveau, vous pouvez aussi spécifier de quelles <a |
| href="programs/configure.html#optionalfeatures">fonctionnalités</a> vous |
| voulez disposer dans Apache en activant ou désactivant des <a |
| href="mod/">modules</a>. Apache est fourni avec un jeu de modules de |
| <a href="mod/module-dict.html#Status">Base</a> inclus par défaut. |
| Les autres modules sont activés à l'aide de l'option |
| <code>--enable-<var>module</var></code>, où |
| <var>module</var> est le nom du module sans la chaîne |
| <code>mod_</code> et où tout caractère de soulignement est converti |
| en tiret. Vous pouvez aussi choisir de compiler les modules comme |
| <a href="dso.html">objets partagés (DSOs)</a> -- qui peuvent être chargés |
| ou déchargés à l'exécution -- à l'aide de l'option |
| <code>--enable-<var>module</var>=shared</code>. D'une manière similaire, |
| vous pouvez désactiver des modules de base à l'aide de l'option |
| <code>--disable-<var>module</var></code> option. Faites très attention |
| en utilisant ces options, car <program>configure</program> 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.</p> |
| |
| <p>En outre, vous devrez peut-être fournir au script |
| <program>configure</program> 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 |
| <program>configure</program>. Pour plus d'informations, voir la |
| page de manuel de <program>configure</program>. Ou lancez le script |
| <program>configure</program> avec l'option <code>--help</code>. |
| </p> |
| |
| <p>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 <code>/sw/pkg/apache</code>, un compilateur et des drapeaux |
| particuliers et les deux modules additionnels <module>mod_rewrite</module> |
| et <module>mod_speling</module> qui pourront être chargés plus tard |
| à l'aide du mécanisme DSO:</p> |
| |
| <example> |
| $ CC="pgcc" CFLAGS="-O2" \<br /> |
| ./configure --prefix=/sw/pkg/apache \<br /> |
| --enable-rewrite=shared \<br /> |
| --enable-speling=shared |
| </example> |
| |
| <p>Quand <program>configure</program> 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.</p> |
| |
| <p>Vous trouverez une description détaillée des options de |
| <program>configure</program> dans sa page de manuel.</p> |
| </section> |
| |
| <section id="compile"><title>Construction</title> |
| |
| <p>Vous pouvez maintenant construire les différents éléments qui |
| composent le paquet Apache en lançant tout simplement la commande :</p> |
| |
| <example>$ make</example> |
| |
| <p>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.</p> |
| </section> |
| |
| <section id="install"><title>Installation</title> |
| |
| <p>Il est temps maintenant d'installer le paquet dans le répertoire |
| d'installation défini par <em>PREFIX</em> (voir plus haut l'option |
| <code>--prefix</code>) en lançant:</p> |
| |
| <example>$ make install</example> |
| |
| <p>Cette étape nécessite habituellement les privilàges |
| de root, car <em>PREFIX</em> est en général un |
| répertoire possàdant des droits en écriture |
| restreints.</p> |
| |
| <p>Si vous effectuez une mise à jour, l'installation n'écrasera pas |
| vos fichiers de configuration ou autres documents.</p> |
| </section> |
| |
| <section id="customize"><title>Personnalisation</title> |
| |
| <p>Ensuite, vous pourrez personnaliser votre Serveur HTTP Apache en |
| éditant les <a href="configuring.html">fichiers de configuration</a> |
| situés dans <code><em>PREFIX</em>/conf/</code>.</p> |
| |
| <example>$ vi <em>PREFIX</em>/conf/httpd.conf</example> |
| |
| <p>Consultez le manuel d'Apache situé dans |
| <code><em>PREFIX</em>/docs/manual/</code> ou |
| <a href="http://httpd.apache.org/docs/&httpd.docs;/" |
| >http://httpd.apache.org/docs/&httpd.docs;/</a> pour la version la plus |
| récente de ce manuel et la liste complète des <a |
| href="mod/directives.html">directives de configuration</a> disponibles.</p> |
| </section> |
| |
| <section id="test"><title>Test</title> |
| |
| <p>Vous pouvez maintenant <a href="invoking.html">démarrer</a> votre |
| serveur HTTP Apache en lançant:</p> |
| |
| <example>$ <em>PREFIX</em>/bin/apachectl -k start</example> |
| |
| <p>Vous devriez alors pouvoir requérir votre premier document |
| à l'aide de l'URL <code>http://localhost/</code>. La page web que vous |
| voyez est située dans le répertoire défini par la directive |
| <directive module="core">DocumentRoot</directive>, |
| qui est généralement <code><em>PREFIX</em>/htdocs/</code>. |
| Pour <a href="stopping.html">arrêter</a> le serveur, lancez:</p> |
| |
| <example>$ <em>PREFIX</em>/bin/apachectl -k stop</example> |
| </section> |
| <section id="upgrading"><title>Mise à jour</title> |
| |
| <p>La première étape d'une mise à jour consiste à lire l'annonce de la |
| sortie de la nouvelle version et le fichier <code>CHANGES</code> |
| 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.</p> |
| |
| <p>La mise à jour d'une version mineure à la suivante (par exemple, de |
| 2.2.55 à 2.2.57) est plus aisée. Le processus <code>make install</code> |
| 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 |
| <program>configure</program>, 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 |
| <program>configure</program> identique, le même fichier de configuration, |
| et tous vos modules continueront de fonctionner.</p> |
| |
| <p>Pour effectuer une mise à jour entre deux versions mineures, |
| commencez par trouver le fichier |
| <code>config.nice</code> dans le répertoire de <code>construction</code> |
| 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 <program>configure</program> 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 <code>config.nice</code> dans |
| l'arborescence des sources de la nouvelle version, de l'éditer pour |
| effectuer toute modification souhaitée, et de lancer:</p> |
| |
| <example> |
| $ ./config.nice<br /> |
| $ make<br /> |
| $ make install<br /> |
| $ <em>PREFIX</em>/bin/apachectl -k graceful-stop<br /> |
| $ <em>PREFIX</em>/bin/apachectl -k start<br /> |
| </example> |
| |
| <note type="warning">Vous devez toujours effectuer un test de la nouvelle |
| version dans votre environnement avant de la mettre en production. |
| Par exemple, vous pouvez installer et exécuter la nouvelle version |
| en parallèle avec l'ancienne en utilisant une option |
| <code>--prefix</code> et un port différents (en ajustant la directive |
| <directive module="mpm_common">Listen</directive>) afin de déceler toute |
| incompatibilité avant d'effectuer la mise à jour définitive.</note> |
| |
| <p>Vous pouvez ajouter des arguments supplémentaires à |
| <code>config.nice</code> ; ils seront alors ajoutés aux options de |
| votre script <program>configure</program> original :</p> |
| |
| <example> |
| $ ./config.nice --prefix=/home/test/apache --with-port=90 |
| </example> |
| |
| </section> |
| </manualpage> |
