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: 1021924:1032413 (outdated) -->
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 vers 2.4 depuis 2.2</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 continuant d'utiliser 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 de la configuration au moment de la 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, reportez-vous à
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 il a été supposé
81 qu'elles n'étaient plus maintenues.</li>
83 <li>configure: les modules dynamiques (DSO) sont compilés par
86 <li>configure: le jeu de modules "most" est compilé par défaut</li>
91 <section id="run-time">
92 <title>Modifications de la configuration à l'exécution</title>
93 <p>Des changements significatifs dans la configuration de
94 l'autorisation, ainsi que quelques changements mineurs, peuvent
95 nécessiter une modification des fichiers de configuration de la version
96 2.2 avant de les utiliser sous la version 2.4.</p>
99 <title>Autorisation</title>
101 <p>Tout fichier de configuration qui gère des autorisations devra
102 probablement être modifié.</p>
104 <p>Vous devez vous reporter au document <a
105 href="howto/auth.html">Authentification, autorisation et contrôle
106 d'accès</a>, et plus particulièrement à la section <a
107 href="howto/auth.html#beyond">Plus loin qu'une simple
108 autorisation</a> qui explique les nouveaux mécanismes permettant de
109 contrôler l'ordre dans lequel les directives d'autorisation sont
110 appliquées.</p>
112 <section id="access">
113 <title>Contrôle d'accès</title>
115 <p>Dans la version 2.2, le contrôle d'accès basé sur le nom d'hôte
116 du client, son adresse IP, ou d'autres caractéristiques de la
117 requête du client était assuré via les directives <directive
118 module="mod_access_compat">Order</directive>, <directive
119 module="mod_access_compat">Allow</directive>, <directive
120 module="mod_access_compat">Deny</directive>, et <directive
121 module="mod_access_compat">Satisfy</directive>.</p>
123 <p>Dans la version 2.4, ce contrôle d'accès est assuré, comme tout
124 contrôle d'autorisation, via le nouveau module
125 <module>mod_authz_host</module>. Bien que le module
126 <module>mod_access_compat</module> soit fourni à des fins de
127 compatibilité avec les anciennes configurations, les anciennes
128 directives de contrôle d'accès devront être remplacées par les
129 nouveaux mécanismes d'authentification.</p>
131 <p>Voici quelques exemples de contrôle d'accès avec l'ancienne et
132 la nouvelle méthode :</p>
134 <p>Dans cet exemple, toutes les requêtes sont rejetées :</p>
136 <title>version 2.2 :</title>
137 Order deny,allow<br />
141 <title>version 2.4 :</title>
145 <p>Dans cet exemple, toutes les requêtes sont acceptées :</p>
147 <title>version 2.2 :</title>
148 Order allow,deny<br />
152 <title>version 2.4 :</title>
156 <p>Dans l'exemple suivant, tous les hôtes du domaine apache.org
157 ont l'autorisation d'accès, tous les autres sont rejetés :</p>
160 <title>version 2.2 :</title>
161 Order Deny,Allow<br />
163 Allow from apache.org
166 <title>version 2.4 :</title>
167 Require host apache.org
173 <section id="config">
174 <title>Autres changements de configuration</title>
176 <p>D'autres ajustements mineurs peuvent s'avérer nécessaires pour
177 certaines configurations particulières, comme décrit ci-dessous.</p>
180 <li>La directive <directive>MaxRequestsPerChild</directive> a
181 été renommée en <directive
182 module="mpm_common">MaxConnectionsPerChild</directive>, ce qui
183 correspond d'avantage à ce qu'elle fait.</li>
185 <li>La directive <directive
186 module="core">DefaultType</directive> ne produit plus aucun
187 effet, si ce n'est d'émettre un avertissement si elle est
188 définie à une valeur autre que <code>none</code>. D'autres
189 directives de configuration la remplacent dans la version 2.4.
192 <li>La valeur par défaut de la directive <directive
193 module="core">EnableSendfile</directive> est maintenant Off.</li>
195 <li><module>mod_log_config</module>: <a
196 href="modules/mod_log_config.html#formats">${cookie}C</a>
197 correspond au nom du cookie dans son ensemble, alors qu'avant,
198 toute sous-chaîne pouvait correspondre.</li>
200 <li><module>mod_dav_fs</module>: le format du fichier <directive
201 module="dav_fs">DavLockDB</directive> a changé pour les systèmes
202 avec inodes. L'ancien fichier <directive
203 module="dav_fs">DavLockDB</directive> doit être supprimé dans le
204 cadre de la mise à jour.
207 <li>La directive <directive module="core">KeepAlive</directive>
208 n'accepte que les valeurs <code>On</code> ou <code>Off</code>.
209 Avant, toute valeur autre que "Off" ou "0" était traitée comme
212 <li>Les directives AcceptMutex, LockFile, RewriteLock, SSLMutex,
213 SSLStaplingMutex et WatchdogMutexPath ont été remplacées par la
214 directive unique <directive module="core">Mutex</directive>.
215 Vous devez évaluer l'impact de ces directives obsolètes dans
216 votre configuration version 2.2 afin de déterminer si elles
217 peuvent être simplement supprimées, ou si elles doivent être
218 remplacées par la directive <directive
219 module="core">Mutex</directive>.</li>
221 <li><module>mod_cache</module>: la directive <directive
222 module="cache">CacheIgnoreURLSessionIdentifiers</directive>
223 effectue maintenent une correspondance exacte dans la chaîne de
224 paramètres au lieu d'une correspondance partielle. Si votre
225 configuration mettait en jeu des sous-chaînes comme
226 <code>sessionid</code> pour correspondre à
227 <code>/une-application/image.gif;jsessionid=123456789</code>,
228 vous devez maintenant utiliser la chaîne de correspondance
229 complète <code>jsessionid</code>.
232 <li><module>mod_ldap</module>: la directive <directive
233 module="ldap">LDAPTrustedClientCert</directive> s'utilise
234 maintenant exclusivement au sein d'une configuration de niveau
235 répertoire. Si vous utilisez cette directive, passez en revue
236 votre configuration pour vous assurer qu'elle est bien présente
237 dans tous les contextes de répertoire nécessaires.</li>
244 <title>Changements divers</title>
247 <li><module>mod_auto_index</module>: extrait maintenant les titres
248 et affiche la description pour les fichiers .xhtml qui étaient
249 jusqu'alors ignorés.</li>
250 <li><program>htpasswd</program> utilise maintenant par défaut les
251 condensés MD5 sur toutes les plates-formes.</li>
256 <section id="third-party">
257 <title>Modules tiers</title>
259 <p>Tous les modules tiers doivent être recompilés pour la
260 version 2.4 avant d'être chargés.</p>
262 <p>De nombreux modules tiers conçus pour la version 2.2
263 fonctionneront sans changement avec le serveur HTTP Apache
264 version 2.4. Certains nécessiterons cependant des modifications ; se
265 reporter à la vue d'ensemble <a
266 href="developer/new_api_2_4.html">Mise à jour de l'API</a>.</p>
268 <section id="commonproblems">
269 <title>Problèmes de mise à jour courants</title>
270 <ul><li>Erreurs au démarrage :
272 <li><code>Invalid command 'User', perhaps misspelled or defined by
273 a module not included in the server configuration</code> - chargez
274 le module <module>mod_unixd</module></li>
275 <li><code>Invalid command 'Require', perhaps misspelled or defined
276 by a module not included in the server configuration</code>, ou
277 <code>Invalid command 'Order', perhaps misspelled or defined by a
278 module not included in the server configuration</code> - chargez
279 le module <module>mod_access_compat</module>, ou mettez à jour
280 vers la version 2.4 les directives d'autorisation.</li>
281 <li><code>Ignoring deprecated use of DefaultType in line NN of
282 /path/to/httpd.conf</code> - supprimez la directive <directive
283 module="core">DefaultType</directive> et remplacez-la par les
284 directives de configuration appropriées.</li>
285 <li><code>mixing * ports and non-* ports with a NameVirtualHost
286 address is not supported</code>, <code>Either NameVirtualHost
287 w.x.y.z:n has no VirtualHosts, or there is more than one identical
288 NameVirtualHost line, or your VirtualHost declarations do not
289 match the NameVirtualHost line</code> -
290 ce ne sont pas des nouveaux messages, mais ils empêchent
291 maintenant le serveur de démarrer</li>
292 <li><code>_default_ is not allowed in NameVirtualHost
293 directive</code> - l'explication est dans le message ; cette
294 définition n'a jamais été valide, mais elle empêche maintenant le
295 serveur de démarrer.</li>
297 <li>Erreurs de traitement des requêtes :
299 <li><code>configuration error: couldn't check user: /path</code> -
300 chargez le module <module>mod_authn_core</module>.</li>