| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" |
| "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| |
| <html xmlns="http://www.w3.org/1999/xhtml"> |
| <head> |
| <meta name="generator" content="HTML Tidy, see www.w3.org" /> |
| <meta http-equiv="Content-Type" |
| content="text/html; charset=iso-8859-1" /> |
| |
| <title>Compilation et installation d'Apache</title> |
| </head> |
| <!-- Background white, links blue (unvisited), navy (visited), red (active) --> |
| |
| <body bgcolor="#FFFFFF" text="#000000" link="#0000FF" |
| vlink="#000080" alink="#FF0000"> |
| <!--#include virtual="header.html" --> |
| |
| <h1 align="CENTER">Compilation et installation d'Apache |
| 1.3</h1> |
| |
| <p>Ce document décrit la compilation et l'installation |
| d'Apache sur les systèmes Unix, en employant la |
| compilation et l'installation manuelle. Si vous souhaitez |
| utiliser l'interface de configuration semblable à |
| autoconf, il est conseillé de lire plutôt le |
| fichier INSTALL situé dans la racine des fichiers |
| sources de la distribution d'Apache. Pour compiler et installer |
| Apache sur d'autres plates-formes, consultez</p> |
| |
| <ul> |
| <li><a href="windows.html">Utilisation d'Apache sur Microsoft |
| Windows</a></li> |
| |
| <li><a href="cygwin.html">Utilisation d'Apache sur |
| Cygwin</a></li> |
| |
| <li><a href="netware.html">Utilisation d'Apache sur Novell |
| Netware</a></li> |
| |
| <li><a href="mpeix.html">Utilisation d'Apache sur HP |
| MPE/iX</a></li> |
| |
| <li><a href="unixware.html">Utilisation d'Apache sur |
| UnixWare</a></li> |
| |
| <li><a href="readme-tpf.html">Aperçu du portage |
| d'Apache sur TPF</a></li> |
| </ul> |
| |
| <h2>Téléchargement d'Apache</h2> |
| Les informations sur la dernière version d'Apache se |
| trouvent sur le site web d'Apache à l'adresse <a |
| href="http://www.apache.org/">http://www.apache.org/</a>. Ce |
| site réunit la version actuelle, les récentes |
| versions beta, ainsi que la liste des sites miroirs web et ftp |
| anonymes. |
| |
| <p>Si vous avez téléchargé une |
| distribution composée des binaires, passez directement |
| à l'<a href="#installing">installation d'Apache</a>. Sinon |
| lisez la section suivante afin de savoir comment compiler le |
| serveur.</p> |
| |
| <h2>Compilation d'Apache</h2> |
| La compilation d'Apache se compose de trois étapes : la |
| sélection des <strong>modules</strong> que vous |
| souhaitez inclure dans le serveur; la création de la |
| configuration pour votre système d'exploitation; la |
| compilation les sources pour créer les |
| exécutables. |
| |
| <p>La configuration d'Apache s'effectue dans le |
| répertoire <code>src</code> de la distribution. Entrez |
| dans ce répertoire.</p> |
| |
| <ol> |
| <li> |
| Sélection des modules à compiler dans Apache |
| définis dans le fichier <code>Configuration</code>. |
| Décommentez les lignes correspondant aux modules que |
| vous souhaitez inclure (parmi les lignes commençant |
| par AddModule situées à la fin du fichier), |
| ou ajoutez de nouvelles lignes correspondant à des |
| modules additionnels que vous avez |
| téléchargés ou écrits. (Voir <a |
| href="misc/API.html">API.html</a> comme documentation |
| préliminaire à l'écriture de modules |
| Apache). Les utilisateurs avertis peuvent commenter |
| certains des modules actifs par défaut si ils sont |
| sûrs qu'ils n'en ont pas besoin (il faut |
| néanmoins faire attention, car la plupart des |
| modules actifs par défaut sont vitaux au bon |
| fonctionnement et à la sécurité du |
| serveur). |
| |
| <p>Vous pouvez également lire les instructions |
| contenues dans le fichier <code>Configuration</code> afin |
| de savoir si devez activer certaines lignes |
| commençant par <code>Rule</code>.</p> |
| </li> |
| |
| <li> |
| Création de la configuration pour votre |
| système d'exploitation. Normalement vous n'avez |
| qu'à exécuter le script |
| <code>Configure</code> comme décrit ci-dessous. |
| Cependant si le script échoue ou si vous avez des |
| besoins particuliers (par exemple inclure une librairie |
| nécessaire à un module optionnel) vous devrez |
| modifier une ou plusieurs des options contenues dans le |
| fichier <code>Configuration</code> : <code>EXTRA_CFLAGS, |
| LIBS, LDFLAGS, INCLUDES</code>. |
| |
| <p>Lancement du script <code>Configure</code> :</p> |
| |
| <blockquote> |
| <pre> |
| % Configure |
| Using 'Configuration' as config file |
| + configured for <whatever> platform |
| + setting C compiler to <whatever> * |
| + setting C compiler optimization-level to <whatever> * |
| + Adding selected modules |
| + doing sanity check on compiler and options |
| Creating Makefile in support |
| Creating Makefile in main |
| Creating Makefile in os/unix |
| Creating Makefile in modules/standard |
| |
| </pre> |
| </blockquote> |
| (*: selon le fichier Configuration et votre système, |
| Configure peut ne pas afficher ces lignes). |
| |
| <p>Ceci crée un fichier Makefile qui sera |
| utilisé lors de l'étape trois. Il crée |
| également un fichier Makefile dans le |
| répertoire <code>support</code>, pour compiler les |
| programmes optionnels d'assistance.</p> |
| |
| <p>(Si vous souhaitez maintenir différentes |
| configurations, <code>Configure</code> accepte une option |
| lui disant de lire un autre fichier de configuration, comme |
| : <code>Configure -file Configuration.ai</code>).</p> |
| </li> |
| |
| <li> |
| Compilation des sources. Tapez : |
| <pre> |
| make |
| </pre> |
| </li> |
| </ol> |
| Les modules contenus dans la distribution Apache sont ceux que |
| nous avons testés et qui ont été |
| utilisés par plusieurs membres de l'équipe de |
| développement d'Apache. Les modules additionnels |
| proposés par les membres ou par d'autres contributeurs |
| correspondant à des besoins ou des fonctions |
| spécifiques sont disponibles à l'adresse <<a |
| href="http://www.apache.org/dist/httpd/contrib/modules/">http://www.apache.org/dist/httpd/contrib/modules/</a>>. |
| Des instructions sont fournies sur cette page pour lier ces |
| modules au noyau d'Apache. |
| |
| <h2><a id="installing" name="installing">Installation |
| d'Apache</a></h2> |
| Vous devez avoir un exécutable appelé |
| <code>httpd</code> dans le répertoire <code>src</code>. |
| Une distribution des binaires doit fournir ce fichier. |
| |
| <p>La prochaine étape est d'installer le programme et de |
| le configurer. Apache est conçu pour être |
| configuré et lancé à partir du même |
| groupe de répertoires que celui où il a |
| été compilé. Si vous souhaitez le lancer |
| d'un autre emplacement, créer un répertoire et y |
| copier les répertoires <code>conf</code>, |
| <code>logs</code> et <code>icons</code>. Dans tous les cas |
| lisez le document <a |
| href="misc/security_tips.html#serverroot">trucs sur la |
| sécurité</a> qui décrit comment affecter |
| les droits sur le répertoire racine du serveur.</p> |
| |
| <p>L'étape suivante est la modification des fichiers de |
| configuration du serveur. Cela consiste à définir |
| différentes <strong>directives</strong> dans les trois |
| fichiers centraux de configuration. Par défaut ces |
| fichiers sont situés dans le répertoire |
| <code>conf</code> et s'appellent <code>srm.conf</code>, |
| <code>access.conf</code> et <code>httpd.conf</code>. Pour vous |
| aider, les mêmes fichiers existent dans le |
| répertoire <code>conf</code> de la distribution et sont |
| appelés <code>srm.conf-dist</code>, |
| <code>access.conf-dist</code> et <code>httpd.conf-dist</code>. |
| Copiez ou renommez ces fichiers en supprimant le |
| <code>-dist</code> pour le nouveau nom. Ensuite éditez |
| chacun de ces fichiers. Lisez attentivement les commentaires de |
| chacun de ces fichiers. Une mauvaise configuration de ces |
| fichiers empêcherait votre serveur de démarrer, ou |
| introduirait un problème de sécurité. Vous |
| devez également trouver dans le répertoire |
| <code>conf</code> un fichier <code>mime.types</code>. |
| Généralement, ce fichier n'a pas besoin |
| d'être modifié.</p> |
| |
| <p>Premièrement éditez le fichier |
| <code>httpd.conf</code>. Celui ci fixe les paramètres |
| généraux du serveur : le numéro de port, |
| l'utilisateur qui l'exécute, etc. Ensuite éditez |
| le fichier <code>srm.conf</code>. Ce fichier définit la |
| racine de l'arborescence des documents, les fonctions |
| spéciales telles que les pages HTML dynamiques, |
| l'analyse des imagemap, etc. Enfin, éditez le fichier |
| <code>access.conf</code> pour au moins définir les |
| schémas d'accès de base.</p> |
| |
| <p>En plus de ces trois fichiers, le comportement du serveur |
| peut être configuré dans chaque répertoire |
| en utilisant les fichiers <code>.htaccess</code> pour les |
| répertoires accédés par le serveur.</p> |
| |
| <h3>Définissez l'heure du système correctement |
| !</h3> |
| Un bon fonctionnement d'un site web public nécessite une |
| heure juste, car des éléments du protocole HTTP |
| sont exprimés en termes de date et heure du jour. Il est |
| donc temps de chercher comment configurer NTP ou un autre |
| produit de synchronisation temporelle sur votre système |
| UNIX, ou un équivalent sous NT. |
| |
| <h3>Démarrage et arrêt du serveur</h3> |
| Pour démarrer le serveur, exécutez |
| <code>httpd</code>. Il cherchera le fichier |
| <code>httpd.conf</code> à l'emplacement |
| spécifié lors de la compilation (par |
| défaut <code>/usr/local/apache/conf/httpd.conf</code>). |
| Si ce fichier est situé autre part, vous pouvez indiquer |
| son emplacement en utilisant l'option -f. Par exemple : |
| <pre> |
| /usr/local/apache/httpd -f /usr/local/apache/conf/httpd.conf |
| </pre> |
| Si tout se passe bien, vous devez vous retrouver de nouveau sur |
| l'invite de commande. Ceci indique que le serveur est actif et |
| s'exécute. Si quelque chose se passe mal durant |
| l'initialisation du serveur, un message d'erreur s'affichera |
| à l'écran. Si le serveur démarre |
| correctement, vous pouvez utiliser votre navigateur, vous |
| connecter au serveur et lire la documentation. Si vous lancez |
| le navigateur à partir de la machine où |
| s'exécute le serveur et que vous utilisez le port par |
| défaut 80, une URL valide à taper dans votre |
| navigateur est : |
| <pre> |
| http://localhost/ |
| </pre> |
| |
| <p>Notez que lors du démarrage du serveur un certain |
| nombre de processus <em>fils</em> sont créés afin |
| de traiter les requêtes. Si vous démarrez le |
| serveur en étant root, le processus père |
| s'exécutera avec les droits de root, tandis que les |
| processus fils s'exécuteront avec les droits de |
| l'utilisateur défini dans le fichier httpd.conf.</p> |
| |
| <p>Si au lancement de <code>httpd</code> celui ci indique qu'il |
| n'arrive pas à s'attacher à une adresse, cela |
| signifie soit qu'un autre processus s'exécute |
| déjà en utilisant le numéro de port |
| défini dans la configuration d'Apache, soit que vous |
| essayez de lancer httpd en tant qu'utilisateur normal et que |
| vous essayez d'utiliser un port inférieur à 1024 |
| (comme le port 80 par exemple).</p> |
| |
| <p>Si le serveur ne s'exécute pas, lisez le message |
| affiché quand vous lancez httpd. Vous devez |
| également vérifier le fichier error_log pour plus |
| d'informations (dans la configuration par défaut ce |
| fichier est situé dans le fichier <code>error_log</code> |
| du répertoire <code>logs</code>).</p> |
| |
| <p>Si vous voulez que votre serveur continue à |
| s'exécuter après une relance du système, |
| vous devez ajouter un appel à <code>httpd</code> dans |
| vos fichiers de démarrage du système (typiquement |
| <code>rc.local</code> ou un fichier dans un répertoire |
| <code>rc.<em>N</em></code>). Ceci lancera le serveur Apache |
| avec les droits de root. Avant de le faire, vérifiez que |
| votre serveur est correctement configuré au niveau de la |
| sécurité et des restrictions d'accès.</p> |
| |
| <p>Pour arrêter Apache, envoyez au processus parent un |
| signal TERM. Le PID de ce processus est écrit dans le |
| fichier <code>httpd.pid</code> situé dans le |
| répertoire <code>logs</code> (à moins qu'Apache |
| soit configuré autrement). N'essayez pas de supprimer |
| les processus fils car d'autres seront créés par |
| le processus père. Une commande typique pour |
| arrêter le serveur est :</p> |
| <pre> |
| kill -TERM `cat /usr/local/apache/logs/httpd.pid` |
| </pre> |
| |
| <p>Pour plus d'information sur les options de la ligne de |
| commande, sur les fichiers de configuration et les fichiers de |
| trace, voir <a href="invoking.html">Démarrage |
| d'Apache</a>. Pour un guide de référence de |
| toutes les directives Apache autorisées par les modules |
| distribués, voir les <a |
| href="mod/directives.html">directives Apache</a> .</p> |
| |
| <h2>Compilation des programmes d'assistance</h2> |
| En plus du serveur <code>httpd</code> qui est compilé et |
| configuré comme ci dessus, Apache inclut un certain |
| nombre de programmes d'assistance. Ceux ci ne sont pas |
| compilés par défaut. Les programmes d'assistance |
| sont situés dans le répertoire |
| <code>support</code> de la distribution. Pour les compiler, |
| allez dans ce répertoire et tapez : |
| <pre> |
| make |
| </pre> |
| <!--#include virtual="footer.html" --> |
| </body> |
| </html> |
| |