invoking.xml.fr revision c988e0b6814e1d0f8eaf9139ca13e2e2a7fcc96e
<?xml version="1.0" encoding="ISO-8859-1" ?>
<!-- LastChangedRevision English document : 420990 -->
<!-- French translation : Lucien GENTIS -->
<!-- $LastChangedRevision: 2007070101 $ -->
<!--
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
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="invoking.xml.meta">
<title>Démarrage d'Apache</title>
<summary>
<p>Apache est habituellement lancé en tant que service
sous Windows NT, 2000 et XP, ou comme application en mode console sous
Windows 9x et ME. Pour plus de détails, voir <a
href="platform/windows.html#winsvc">Démarrer Apache en tant que service</a>
et <a href="platform/windows.html#wincons">Démarrer Apache comme
Application en mode console</a>.</p>
<p>Sous Unix, le programme <program>httpd</program>
est lancé en mode démon et s'exécute de manière permanente en
arrière-plan pour gérer les requêtes. Ce document décrit comment invoquer
<program>httpd</program>.</p>
</summary>
<seealso><program>httpd</program></seealso>
<seealso><program>apachectl</program></seealso>
<section id="startup"><title>Comment Apache démarre</title>
<p>Si la directive <directive module="mpm_common">Listen</directive>
spécifiée dans le fichier de configuration est à sa valeur par défaut
de 80 (ou tout autre port inférieur à 1024), il est nécessaire de
posséder les privilèges root pour pouvoir démarrer apache, et lui
permettre d'être associé à ce port privilégié. Lorsque le serveur est
démarré, après avoir effectué quelques opérations préliminaires
comme ouvrir ses fichiers de log, il lance plusieurs processus
<em>enfants</em> qui ont pour rôle d'écouter et de répondre aux
requêtes des clients. Le processus <code>httpd</code> principal
continue à s'exécuter sous l'utilisateur root, tandis que les processus
enfants s'exécutent sous un utilisateur aux privilèges restreints.
Ceci s'effectue par la voie du
<p>Il est recommandé d'utiliser le script de contrôle
<program>apachectl</program> pour invoquer l'exécutable
<program>httpd</program>. Avant d'invoquer le binaire
<program>httpd</program>, ce script définit certaines variables
d'environnement nécessaires pour permettre à
<program>httpd</program> de fonctionner correctement sous certains systèmes
d'exploitation.
<program>apachectl</program> accepte des arguments de ligne de commande,
ainsi toute option de <program>httpd</program> peut aussi être utilisée avec
<program>apachectl</program>. Vous pouvez aussi éditer directement le
script <program>apachectl</program> en modifiant la variable
<code>HTTPD</code> située en début de script pour spécifier la
localisation du binaire <program>httpd</program> et tout argument de ligne
de commande que vous souhaitez voir <em>systématiquement</em> présent.</p>
<p>La première chose qu'effectue <code>httpd</code> quand il est
invoqué et de localiser et lire le <a
href="configuring.html">fichier de configuration</a>
compilation, mais il est possible d'en spécifier une autre à
l'exécution en utilisant l'option de ligne de commande <code>-f</code> comme suit:</p>
<p>Si tout se passe bien pendant le démarrage, le serveur va se dissocier
du terminal et l'invite de commande réapparaîtra presque immédiatement.
Ceci indique que le serveur a démarré et est en cours d'exécution.
À partir de ce moment, vous pouvez utiliser votre navigateur pour vous connecter
au serveur et afficher la page de test située dans le répertoire défini
par la directive <directive module="core">DocumentRoot</directive>,
ainsi qu'une copie locale de la documentation sous forme d'un lien
situé sur cette page.
(note du traducteur : en fait, vous ne devriez voir que "It works !"
s'afficher sur votre écran !)</p>
</section>
<section id="errors"><title>Erreurs en cours de démarrage</title>
<p>Si Apache rencontre un problème fatal pendant le démarrage, il va
afficher un message décrivant le problème sur la console ou
enregistrer ces informations dans le fichier défini par la directive
<directive module="core">ErrorLog</directive> avant de quitter.
Un des messages d'erreur les plus courants est "<code>Unable
to bind to Port ...</code>". Ce message d'erreur est habituellement
provoqué par:</p>
<ul>
<li>Une tentative de démarrage du serveur avec un port privilégié sans
être connecté root; ou</li>
<li>Une tentative de démarrage du serveur alors qu'une autre instance
d'Apache ou un autre serveur web est déjà associé au même port.</li>
</ul>
<p>Pour plus d'instructions de dépannage, consultez la
<a href="faq/">FAQ</a> Apache.</p>
</section>
<section id="boot"><title>Lancement au démarrage du système</title>
<p>Si vous souhaitez que votre serveur continue de fonctionner après
un redémarrage du système, vous devez ajouter un appel à
<program>apachectl</program> à vos
l'utilisateur root. Avant de faire ceci, assurez-vous que votre serveur
est correctement configuré en ce qui concerne la sécurité et les
restrictions d'accès.</p>
<p>Le script <program>apachectl</program> est conçu pour fonctionner
comme un script d'initialisation SysV standard; il accepte les arguments
<code>start</code>, <code>restart</code>, et <code>stop</code>
et les traduit en signaux appropriés pour
<program>httpd</program>. Il est ainsi souvent possible d'installer
simplement un lien vers
<program>apachectl</program> dans le répertoire d'initialisation approprié.
Mais prenez soin de vérifier les besoins exacts de votre système
en la matière.</p>
</section>
<section id="info"><title>Informations supplémentaires</title>
<p>Des informations supplémentaires à propos des options en ligne de
commande de <program>httpd</program> et <program>apachectl</program>
ainsi que d'autres programmes support inclus dans la distribution
sont disponibles sur la page
<a href="programs/">Le serveur et ses programmes support</a>.
Il existe aussi une documentation sur tous les <a
href="mod/">modules</a> inclus dans la distribution Apache
qu'ils supportent.</p>
</section>
</manualpage>