1 <?xml version="1.0" encoding="ISO-8859-1" ?>
2 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
3 <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
4 <!-- French translation : Lucien GENTIS -->
5 <!-- Reviewed by : Vincent Deffontaines -->
6 <!-- English Revision : 1204356 -->
9 Licensed to the Apache Software Foundation (ASF) under one or more
10 contributor license agreements. See the NOTICE file distributed with
11 this work for additional information regarding copyright ownership.
12 The ASF licenses this file to You under the Apache License, Version 2.0
13 (the "License"); you may not use this file except in compliance with
14 the License. You may obtain a copy of the License at
16 http://www.apache.org/licenses/LICENSE-2.0
18 Unless required by applicable law or agreed to in writing, software
19 distributed under the License is distributed on an "AS IS" BASIS,
20 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21 See the License for the specific language governing permissions and
22 limitations under the License.
25 <manualpage metafile="upgrading.xml.meta">
27 <title>Mise à jour de la version 2.2 vers la version 2.4</title>
30 <p>Afin d'assister les utilisateurs lors de leurs opérations de mise à
31 jour, nous maintenons un document
32 qui comporte des informations critiques à l'attention des personnes qui
33 utilisent déjà le serveur HTTP Apache. Ces informations
34 ne sont que de brèves notes, et vous
35 trouverez plus d'informations dans le document <a
36 href="new_features_2_4.html">Nouvelles fonctionnalités</a>, ou dans
37 le fichier <code>src/CHANGES</code>. Les développeurs d'applications
38 et de modules trouveront un résumé des modifications de l'API dans la
39 vue d'ensemble <a href="developer/new_api_2_4.html">Mises à jour de
42 <p>Ce document présente les changements de comportement du serveur qui
43 peuvent nécessiter une modification de la configuration, et la manière
44 d'utiliser la version 2.4 du serveur en parallèle avec la
45 version 2.2. Pour tirer parti des nouvelles fonctionnalités de la
46 version 2.4, reportez-vous au document "Nouvelles fonctionnalités".</p>
48 <p>Ce document ne décrit que les modifications intervenues entre les versions
49 2.2 et 2.4. Si vous effectuez une mise à jour depuis la version 2.0, vous
50 devez aussi consulter le
51 <a href="http://httpd.apache.org/docs/2.2/upgrading.html">document de mise
52 à jour de 2.0 vers 2.2.</a></p>
55 <seealso><a href="new_features_2_4.html">Vue d'ensemble des nouvelles
56 fonctionnalités du serveur HTTP Apache 2.4</a></seealso>
58 <section id="compile-time">
59 <title>Modifications des paramètres de compilation</title>
60 <p>Le processus de compilation est très similaire à celui de la
61 version 2.2. Dans la plupart des cas, vous pourrez utiliser votre
62 ancienne ligne de commande <code>configure</code> (telle qu'elle
63 est enregistrée dans le fichier <code>build/config.nice</code>
64 situé dans le répertoire de compilation du serveur). Voici certains
65 changements intervenus dans la configuration par défaut :</p>
68 <li>Les modules suivants ont été supprimés : mod_authn_default,
69 mod_authz_default et mod_mem_cache. Si vous utilisiez
70 mod_mem_cache sous la version 2.2, vous devez maintenant utiliser
71 <module>mod_cache_disk</module> dans la version 2.4.</li>
73 <li>Toutes les implémentations de répartition de charge ont été
74 déplacées vers des sous-modules spécifiques de mod_proxy, comme
75 <module>mod_lbmethod_bybusyness</module>. Vous devrez compiler et
76 chargés tous les modules correspondants que votre configuration
79 <li>Le support de BeOS, TPF, et des anciennes plates-formes telles
80 que A/UX, Next, et Tandem a été supprimé, car
81 elles ne sont plus considérées comme maintenues.</li>
83 <li>configure: les modules dynamiques (DSO) sont compilés par
86 <li>configure: par défaut, seul un jeu de modules de base est
87 chargé. Les autres directives <directive>LoadModule</directive>
88 sont mises en commentaires.</li>
90 <li>configure: le jeu de modules "most" est compilé par défaut</li>
92 <li>configure: le jeu de modules "reallyall" ajoute les modules de
93 développeur au jeu "all".</li>
98 <section id="run-time">
99 <title>Modifications de la configuration à l'exécution</title>
100 <p>Des changements significatifs dans la configuration de
101 l'autorisation, ainsi que quelques changements mineurs, peuvent
102 nécessiter une mise à jour des fichiers de configuration de la version
103 2.2 avant de les utiliser sous la version 2.4.</p>
106 <title>Autorisation</title>
108 <p>Tout fichier de configuration qui gère des autorisations devra
109 probablement être mis à jour.</p>
111 <p>Vous devez vous reporter au document <a
112 href="howto/auth.html">Authentification, autorisation et contrôle
113 d'accès</a>, et plus particulièrement à la section <a
114 href="howto/auth.html#beyond">Plus loin qu'une simple
115 autorisation</a> qui explique les nouveaux mécanismes permettant de
116 contrôler l'ordre dans lequel les directives d'autorisation sont
117 appliquées.</p>
119 <section id="access">
120 <title>Contrôle d'accès</title>
122 <p>Dans la version 2.2, le contrôle d'accès basé sur le nom d'hôte
123 du client, son adresse IP, ou d'autres caractéristiques de la
124 requête était assuré via les directives <directive
125 module="mod_access_compat">Order</directive>, <directive
126 module="mod_access_compat">Allow</directive>, <directive
127 module="mod_access_compat">Deny</directive>, et <directive
128 module="mod_access_compat">Satisfy</directive>.</p>
130 <p>Dans la version 2.4, ce contrôle d'accès est assuré, comme tout
131 contrôle d'autorisation, via le nouveau module
132 <module>mod_authz_host</module>. Bien que le module
133 <module>mod_access_compat</module> soit fourni à des fins de
134 compatibilité avec les anciennes configurations, les anciennes
135 directives de contrôle d'accès devront être remplacées par les
136 nouveaux mécanismes d'authentification.</p>
138 <p>Voici quelques exemples de contrôle d'accès avec l'ancienne et
139 la nouvelle méthode :</p>
141 <p>Dans cet exemple, toutes les requêtes sont rejetées :</p>
143 <title>version 2.2 :</title>
144 Order deny,allow<br />
148 <title>version 2.4 :</title>
152 <p>Dans cet exemple, toutes les requêtes sont acceptées :</p>
154 <title>version 2.2 :</title>
155 Order allow,deny<br />
159 <title>version 2.4 :</title>
163 <p>Dans l'exemple suivant, tous les hôtes du domaine example.org
164 ont l'autorisation d'accès, tous les autres sont rejetés :</p>
167 <title>version 2.2 :</title>
168 Order Deny,Allow<br />
170 Allow from example.org
173 <title>version 2.4 :</title>
174 Require host example.org
180 <section id="config">
181 <title>Autres changements dans la configuration</title>
183 <p>D'autres ajustements mineurs peuvent s'avérer nécessaires pour
184 certaines configurations particulières, comme décrit ci-dessous.</p>
187 <li><directive>MaxRequestsPerChild</directive> a été renommée en
188 <directive module="mpm_common">MaxConnectionsPerChild</directive>;
189 ce nouveau nom reflète mieux l'usage de cette directive.
190 L'ancien nom est encore supporté.</li>
192 <li>La directive <directive>MaxClients</directive> a
193 été renommée en <directive
194 module="mpm_common">MaxRequestWorkers</directive>; ce nouveau
195 nom reflète mieux l'usage de cette directive. Pour les
196 modules multiprocessus asynchrones, comme <module>event</module>, le nombre
197 maximal de clients n'est pas équivalent au nombre de threads du
198 worker. L'ancien nom est encore supporté.</li>
200 <li>La directive <directive
201 module="core">DefaultType</directive> ne produit plus aucun
202 effet, si ce n'est d'émettre un avertissement si elle est
203 définie à une valeur autre que <code>none</code>. D'autres
204 directives de configuration la remplacent dans la version 2.4.
207 <li>La valeur par défaut de la directive <directive
208 module="core">EnableSendfile</directive> est maintenant Off.</li>
210 <li>La valeur par défaut de la directive <directive
211 module="core">FileETag</directive> est maintenant "MTime Size"
214 <li><module>mod_log_config</module>: <a
215 href="modules/mod_log_config.html#formats">${cookie}C</a>
216 correspond au nom du cookie dans son ensemble, alors qu'avant,
217 toute sous-chaîne pouvait correspondre.</li>
219 <li><module>mod_dav_fs</module>: le format du fichier <directive
220 module="mod_dav_fs">DavLockDB</directive> a changé pour les systèmes
221 avec inodes. L'ancien fichier <directive
222 module="mod_dav_fs">DavLockDB</directive> doit être supprimé dans le
223 cadre de la mise à jour.
226 <li>La directive <directive module="core">KeepAlive</directive>
227 n'accepte que les valeurs <code>On</code> ou <code>Off</code>.
228 Avant, toute valeur autre que "Off" ou "0" était traitée comme
231 <li>Les directives AcceptMutex, LockFile, RewriteLock, SSLMutex,
232 SSLStaplingMutex et WatchdogMutexPath ont été remplacées par la
233 directive unique <directive module="core">Mutex</directive>.
234 Vous devez évaluer l'impact de ces directives obsolètes dans
235 votre configuration version 2.2 afin de déterminer si elles
236 peuvent être simplement supprimées, ou si elles doivent être
237 remplacées par la directive <directive
238 module="core">Mutex</directive>.</li>
240 <li><module>mod_cache</module>: la directive <directive
241 module="mod_cache">CacheIgnoreURLSessionIdentifiers</directive>
242 effectue maintenant une correspondance exacte dans la chaîne de
243 paramètres au lieu d'une correspondance partielle. Si votre
244 configuration mettait en jeu des sous-chaînes comme
245 <code>sessionid</code> pour correspondre à
246 <code>/une-application/image.gif;jsessionid=123456789</code>,
247 vous devez maintenant utiliser la chaîne de correspondance
248 complète <code>jsessionid</code>.
251 <li><module>mod_ldap</module>: la directive <directive
252 module="mod_ldap">LDAPTrustedClientCert</directive> s'utilise
253 maintenant exclusivement au sein d'une configuration de niveau
254 répertoire. Si vous utilisez cette directive, passez en revue
255 votre configuration pour vous assurer qu'elle est bien présente
256 dans tous les contextes de répertoire nécessaires.</li>
258 <li><module>mod_filter</module>: la syntaxe de la directive
259 <directive module="mod_filter">FilterProvider</directive> utilise
260 maintenant une expression booléenne pour déterminer si un filtre
264 <li><module>mod_include</module>:
266 <li>L'élément <code>#if expr</code> utilise maintenant le
267 nouvel <a href="expr.html">interpréteur d'expressions</a>.
268 L'ancienne syntaxe peut être réactivée via la directive
270 module="mod_include">SSILegacyExprParser</directive>.
272 <li>Dans la portée du répertoire, une directive de
273 configuration SSI* ne provoque plus la réinitialisation à
274 leur valeur par défaut de toutes les directives SSI* de
275 niveau répertoire.</li>
279 <li><module>mod_charset_lite</module> : l'option
280 <code>DebugLevel</code> a été supprimée en faveur d'une
281 configuration de la directive <directive
282 module="core">LogLevel</directive> au niveau répertoire.
285 <li><module>mod_ext-filter</module> : l'option
286 <code>DebugLevel</code> a été supprimée en faveur d'une
287 configuration de la directive <directive
288 module="core">LogLevel</directive> au niveau répertoire.
291 <li><module>mod_ssl</module>: le contrôle de révocation des
292 certificats basé sur les CRL doit être maintenant explicitement
293 configuré via la directive <directive
294 module="mod_ssl">SSLCARevocationCheck</directive>.
297 <li><module>mod_substitute</module>: la taille maximale d'une
298 ligne est maintenant 1Mo.
301 <li><module>mod_reqtimeout</module>: si ce module est chargé, il
302 définit maintenant certains temps d'attente par défaut.</li>
309 <title>Changements divers</title>
312 <li><module>mod_auto_index</module>: extrait maintenant les titres
313 et affiche la description pour les fichiers .xhtml qui étaient
314 jusqu'alors ignorés.</li>
316 <li><module>mod_ssl</module> : le format par défaut des variables
317 <code>*_DN</code> a changé. Il est cependant encore possible
318 d'utiliser l'ancien format via la nouvelle option
319 <code>LegacyDNStringFormat</code> de la directive <directive
320 module="mod_ssl">SSLOptions</directive>. Le protocole SSLv2 n'est
321 plus supporté.</li>
323 <li><program>htpasswd</program> utilise maintenant par défaut les
324 condensés MD5 sur toutes les plates-formes.</li>
326 <li>La directive <directive
327 module="core">NameVirtualHost</directive> n'a plus aucun effet, si
328 ce n'est l'émission d'un avertissement. Toute combinaison
329 adresse/port apparaissant dans plusieurs serveurs virtuels est
330 traitée implicitement comme un serveur virtuel basé sur le nom.
333 <li><module>mod_deflate</module> n'effectue plus de compression
334 s'il s'aperçoit que la quantité de données ajoutée par la
335 compression est supérieure à la quantité de données à compresser.
338 <li>Les pages d'erreur multilingues de la version 2.2.x ne
339 fonctionneront qu'après avoir été corrigées pour
340 respecter la nouvelle syntaxe de l'élément <code>#if expr=</code>
341 du module <module>mod_include</module>, ou si la directive
342 <directive module="mod_include">SSILegacyExprParser</directive> a
343 été activée pour le répertoire contenant les pages d'erreur.
349 <section id="third-party">
350 <title>Modules tiers</title>
352 <p>Tous les modules tiers doivent être recompilés pour la
353 version 2.4 avant d'être chargés.</p>
355 <p>De nombreux modules tiers conçus pour la version 2.2
356 fonctionneront sans changement avec le serveur HTTP Apache
357 version 2.4. Certains nécessiterons cependant des modifications ; se
358 reporter à la vue d'ensemble <a
359 href="developer/new_api_2_4.html">Mise à jour de l'API</a>.</p>
361 <section id="commonproblems">
362 <title>Problèmes de mise à jour courants</title>
363 <ul><li>Erreurs au démarrage :
365 <li><code>Invalid command 'User', perhaps misspelled or defined by
366 a module not included in the server configuration</code> - chargez
367 le module <module>mod_unixd</module></li>
369 <li><code>Invalid command 'Require', perhaps misspelled or defined
370 by a module not included in the server configuration</code>, ou
371 <code>Invalid command 'Order', perhaps misspelled or defined by a
372 module not included in the server configuration</code> - chargez
373 le module <module>mod_access_compat</module>, ou mettez à jour
374 vers la version 2.4 les directives d'autorisation.</li>
375 <li><code>mixing * ports and non-* ports with a NameVirtualHost address is not supported</code>, <code>Either NameVirtualHost w.x.y.z:n has no VirtualHosts, or there is more than one identical NameVirtualHost line, or your VirtualHost declarations do not match the NameVirtualHost line</code> - ces messages ne sont pas nouveaux, mais ils bloquent désormais le démarrage en générant une erreur</li>
377 <li><code>_default_ is not allowed in NameVirtualHost directive</code> - ceci a toujours été le cas, mais à présent cette erreur bloque le démarrage du serveur.</li>
379 <li><code>Ignoring deprecated use of DefaultType in line NN of
380 /path/to/httpd.conf</code> - supprimez la directive <directive
381 module="core">DefaultType</directive> et remplacez-la par les
382 directives de configuration appropriées.</li>
383 <li><code>mixing * ports and non-* ports with a NameVirtualHost
384 address is not supported</code>, <code>Either NameVirtualHost
385 w.x.y.z:n has no VirtualHosts, or there is more than one identical
386 NameVirtualHost line, or your VirtualHost declarations do not
387 match the NameVirtualHost line</code> -
388 ce ne sont pas des nouveaux messages, mais ils empêchent
389 maintenant le serveur de démarrer</li>
390 <li><code>_default_ is not allowed in NameVirtualHost
391 directive</code> - l'explication est dans le message ; cette
392 définition n'a jamais été valide, mais elle empêche maintenant le
393 serveur de démarrer.</li>
395 <li>Erreurs de traitement des requêtes :
397 <li><code>configuration error: couldn't check user: /path</code> -
398 chargez le module <module>mod_authn_core</module>.</li>