-
Notifications
You must be signed in to change notification settings - Fork 1.1k
/
install.xml.fr
434 lines (351 loc) · 20.7 KB
/
install.xml.fr
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
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
<?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: 1061947 -->
<!--
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 du serveur
HTTP Apache
sur les systèmes Unix et similaires seulement. Pour la compilation et
l'installation sous Windows, voir <a
href="platform/windows.html">Utiliser le serveur HTTP 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 httpd</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 httpd sont les suivants:</p>
<dl>
<dt>Espace disque</dt>
<dd>Assurez-vous d'avoir au moins 50 Mo d'espace disque disponible
temporaire. Après l'installation le serveur occupe
approximativement 10 Mo d'espace disque. L'espace disque réellement
nécessaire va varier considérablement en fonction de vos options
de configuration, de la présence éventuelle de
modules tiers, et bien entendu de la taille de votre site web et
des sites que vous hébergez sur votre serveur.</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://gcc.gnu.org/">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 du serveur HTTP Apache 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>
accepte 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 grand nombre de
modules inclus par défaut. Ils seront compilés en tant qu'<a
href="dso.html">objets partagés (DSOs)</a> qui pourront être chargés
ou déchargés à l'exécution. Vous pouvez aussi choisir de compiler
les modules statiquement via l'option
<code>--enable-<var>module</var>=static</code>.</p>
<p>Des modules supplémentaires peuvent être 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. D'une manière similaire,
vous pouvez désactiver des modules à l'aide de l'option
<code>--disable-<var>module</var></code>. 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 bibliothèques, 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_ldap</module>
et <module>mod_lua</module> :</p>
<example>
$ CC="pgcc" CFLAGS="-O2" \<br />
./configure --prefix=/sw/pkg/apache \<br />
--enable-ldap=shared \<br />
--enable-lua=shared
</example>
<p>Plusieurs minutes peuvent être nécessaires à
<program>configure</program> 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 2.0 à 2.2 ou de 2.2 à 2.3),
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>
<section id="thirdp"><title>Paquets tiers</title>
<p>De nombreux tiers fournissent leur propre distribution du
serveur HTTP Apache à installer sur une plate-forme particulière. On
peut citer les différentes distributions Linux, divers
paquets tiers Windows, Mac OS X, Solaris et de nombreux autres.</p>
<p>Notre license logicielle non seulement permet, mais aussi
encourage ce genre de redistribution. Cependant, ceci conduit à une
situation ou l'organisation de la configuration et les valeurs par
défaut de votre installation du serveur peuvent ne pas correspondre
à ce qui est écrit dans la documentation. Bien que fâcheuse, cette
situation n'est pas appelée à évoluer de sitôt.</p>
<p>Une <a
href="http://wiki.apache.org/httpd/DistrosDefaultLayout">description
de ces distributions tierces</a> est maintenue dans le wiki du
serveur HTTP, et doit en refléter l'état actuel. Vous devrez
cependant vous familiariser par vous-même avec la gestion du paquet
de votre plate-forme particulière et les procédures d'installation.</p>
</section>
</manualpage>