1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
<?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: 1597021 -->
<!--
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="invoking.xml.meta">
<title>Démarrage d'Apache</title>
<summary>
<p>Sous Windows, Apache est habituellement lancé en tant que
service. Pour plus de détails, voir <a
href="platform/windows.html#winsvc">Démarrer Apache en tant
que service</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><a href="stopping.html">Arrêt et redémarrage</a></seealso>
<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
<a href="mpm.html">Module Multi-Processus (MPM)</a>.</p>
<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 <program>httpd</program> quand il est
invoqué est de localiser et lire le <a
href="configuring.html">fichier de configuration</a>
<code>httpd.conf</code>. La localisation de ce fichier est définie à la
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>
<example>/usr/local/apache2/bin/apachectl -f
/usr/local/apache2/conf/httpd.conf</example>
<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></p>
</section>
<section id="errors"><title>Erreurs en cours de démarrage</title>
<p>Si un problème fatal survient pendant le démarrage
d'Apache, ce dernier 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</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="http://wiki.apache.org/httpd/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 fonctionne après
un redémarrage du système, vous devez ajouter un appel à
<program>apachectl</program> à vos
fichiers de démarrage système (en général <code>rc.local</code> ou un
fichier dans un répertoire <code>rc.N</code>), ce qui démarrera Apache sous
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>, et il suffit en général d'installer
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
et les <a href="mod/directives.html">directives</a>
qu'ils supportent.</p>
</section>
</manualpage>
|