<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 931689 -->
+<!-- English Revision : 956059 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
générale.</p>
</note>
- <p>Depuis la version 2.1 du serveur HTTP Apache, il est possible d'utiliser un jeu de
- connexions vers un serveur d'arrière-plan. Il est possible de
- personnaliser ce jeu de connexions à l'aide des paramètres
- <code>clé=valeur</code>. La valeur par défaut du nombre maximum de
- connexions correspond au nombre de threads par processus pour le MPM
- utilisé. Pour le MPM Prefork, cette valeur est toujours 1, alors que
- pour le MPM Worker, elle est contrôlée par la directive
- <directive>ThreadsPerChild</directive>.</p>
-
- <p>La définition de <code>min</code> va déterminer le nombre minimum
- de connexions ouvertes vers le serveur d'arrière-plan. Des
- connexions pourront être créées à la demande à concurrence du
- maximum relatif, soit <code>smax</code>. Toute
- connexion au dessus de <code>smax</code> se verra attribuer une
- durée de vie <code>ttl</code>. Apache httpd ne créera jamais plus de
- connexions vers le serveur d'arrière-plan que le maximum absolu,
- soit <code>max</code>.</p>
+ <p>Depuis la version 2.1 du serveur HTTP Apache, mod_proxy supporte
+ les groupements de connexions vers un serveur d'arrière-plan. Les
+ connexions créées à la demande peuvent être enregistrées dans un
+ groupement pour une utilisation ultérieure. La taille du groupe
+ ainsi que d'autres caractéristiques peuvent être définies via la
+ directive <directive>ProxyPass</directive> au moyen de paramètres
+ <code>clé=valeur</code> dont la description fait l'objet du tableau
+ ci-dessous.</p>
+
+ <p>La définition du paramètre <code>min</code> permet de déterminer
+ le nombre de connexions vers le serveur d'arrière-plan qui seront
+ conservées après usage. Il sera possible de créer jusqu'à
+ <code>smax</code> (Soft Maximum) connexions à la demande. Toute
+ connexion en surnombre par rapport à <code>smax</code> aura une
+ durée de vie limitée, ou <code>ttl</code>. En tout état de cause,
+ Apache httpd ne créera jamais plus de <code>max</code> (Hard
+ Maximum) connexions vers le serveur d'arrière-plan.</p>
+
+ <p>Le groupement de connexions est maintenu au niveau de chaque
+ processus enfant du serveur web, et les définitions de
+ <code>min</code>, <code>max</code>, et <code>smax</code> ne font
+ l'objet d'aucune coordination entre les différents processus
+ enfants, sauf si un seul processus enfant est autorisé par la
+ configuration ou la conception du module multi-processus (MPM).</p>
- <example>
+ <example><title>Exemple</title>
ProxyPass /exemple http://backend.example.com smax=5 max=20 ttl=120 retry=300
</example>
<th>Description</th></tr>
<tr><td>min</td>
<td>0</td>
- <td>Nombre minimum de connexions ouvertes vers le serveur
- d'arrière-plan.</td></tr>
+ <td>Nombre minimum de connexions vers le serveur
+ d'arrière-plan qui seront conservées après usage.</td></tr>
<tr><td>max</td>
<td>1...n</td>
<td>Nombre maximum absolu de connexions autorisées vers le
<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 922232:959136 (outdated) -->
+<!-- English Revision: 959136 -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
ne sont que de brèves notes, et vous
trouverez plus d'informations dans le document <a
href="new_features_2_4.html">Nouvelles fonctionnalités</a>, ou dans
- le fichier <code>src/CHANGES</code>.</p>
+ le fichier <code>src/CHANGES</code>. Les développeurs d'applications
+ et de modules trouveront un résumé des modifications de l'API dans la
+ vue d'ensemble <a href="developer/new_api_2_4.html">Mises à jour de
+ l'API</a>.</p>
+
+ <p>Ce document présente les changements de comportement du serveur qui
+ peuvent nécessiter une modification de la configuration, et la manière
+ d'utiliser la version 2.4 du serveur en continuant d'utiliser la
+ version 2.2. Pour tirer parti des nouvelles fonctionnalités de la
+ version 2.4, reportez-vous au document "Nouvelles fonctionnalités".</p>
<p>Ce document ne décrit que les modifications intervenues entre les versions
2.2 et 2.4. Si vous effectuez une mise à jour depuis la version 2.0, vous
<section id="compile-time">
<title>Modifications de la configuration au moment de la compilation</title>
- <!-- <ul>
- </ul> -->
+ <p>Le processus de compilation est très similaire à celui de la
+ version 2.2. Dans la plupart des cas, vous pourrez utiliser votre
+ ancienne ligne de commande <code>configure</code> (telle qu'elle
+ est enregistrée dans le fichier <code>build/config.nice</code>
+ situé dans le répertoire de compilation du serveur). Voici certains
+ changements intervenus dans la configuration par défaut :</p>
+
+ <ul>
+ <li>Les modules suivants ont été supprimés : mod_authn_default,
+ mod_authz_default et mod_mem_cache. Si vous utilisiez
+ mod_mem_cache sous la version 2.2, reportez-vous à
+ <module>mod_disk_cache</module> dans la version 2.4.</li>
+
+ <li>Toutes les implémentations de répartition de charge ont été
+ déplacées vers des sous-modules spécifiques de mod_proxy, comme
+ <module>mod_lbmethod_bybusyness</module>. Vous devrez compiler et
+ chargés tous les modules correspondants que votre configuration
+ utilise.</li>
+
+ <li>Le support de BeOS, TPF, et des anciennes plates-formes telles
+ que A/UX, Next, et Tandem a été supprimé, car il a été supposé
+ qu'elles n'étaient plus maintenues.</li>
+
+ <li>configure: les modules dynamiques (DSO) sont compilés par
+ défaut</li>
+
+ <li>configure: le jeu de modules "most" est compilé par défaut</li>
+ </ul>
</section>
<section id="run-time">
<title>Modifications de la configuration à l'exécution</title>
+<p>Des changements significatifs dans la configuration de
+l'autorisation, ainsi que quelques changements mineurs, peuvent
+nécessiter une modification des fichiers de configuration de la version
+2.2 avant de les utiliser sous la version 2.4.</p>
+
+ <section id="authz">
+ <title>Autorisation</title>
+
+ <p>Tout fichier de configuration qui gère des autorisations devra
+ probablement être modifié.</p>
+
+ <p>Vous devez vous reporter au document <a
+ href="howto/auth.html">Authentification, autorisation et contrôle
+ d'accès</a>, et plus particulièrement à la section <a
+ href="howto/auth.html#beyond">Plus loin qu'une simple
+ autorisation</a> qui explique les nouveaux mécanismes permettant de
+ contrôler l'ordre dans lequel les directives d'autorisation sont
+ appliquées.</p>
- <!-- <ul>
- </ul> -->
+ <section id="access">
+ <title>Contrôle d'accès</title>
+ <p>Dans la version 2.2, le contrôle d'accès basé sur le nom d'hôte
+ du client, son adresse IP, ou d'autres caractéristiques de la
+ requête du client était assuré via les directives <directive
+ module="mod_access_compat">Order</directive>, <directive
+ module="mod_access_compat">Allow</directive>, <directive
+ module="mod_access_compat">Deny</directive>, et <directive
+ module="mod_access_compat">Satisfy</directive>.</p>
+
+ <p>Dans la version 2.4, ce contrôle d'accès est assuré, comme tout
+ contrôle d'autorisation, via le nouveau module
+ <module>mod_authz_host</module>. Bien que le module
+ <module>mod_access_compat</module> soit fourni à des fins de
+ compatibilité avec les anciennes configurations, les anciennes
+ directives de contrôle d'accès devront être remplacées par les
+ nouveaux mécanismes d'authentification.</p>
+
+ <p>Voici quelques exemples de contrôle d'accès avec l'ancienne et
+ la nouvelle méthode :</p>
+
+ <p>Dans cet exemple, toutes les requêtes sont rejetées :</p>
+ <example>
+ <title>version 2.2 :</title>
+ Order deny,allow<br />
+ Deny from all
+ </example>
+ <example>
+ <title>version 2.4 :</title>
+ Require all denied
+ </example>
+
+ <p>Dans cet exemple, toutes les requêtes sont acceptées :</p>
+ <example>
+ <title>version 2.2 :</title>
+ Order allow,deny<br />
+ Allow from all
+ </example>
+ <example>
+ <title>version 2.4 :</title>
+ Require all granted
+ </example>
+
+ <p>Dans l'exemple suivant, tous les hôtes du domaine apache.org
+ ont l'autorisation d'accès, tous les autres sont rejetés :</p>
+
+ <example>
+ <title>version 2.2 :</title>
+ Order Deny,Allow<br />
+ Deny from all<br />
+ Allow from apache.org
+ </example>
+ <example>
+ <title>version 2.4 :</title>
+ Require host apache.org
+ </example>
+ </section>
+
+ </section>
+
+ <section id="config">
+ <title>Autres changements de configuration</title>
+
+ <p>D'autres ajustements mineurs peuvent s'avérer nécessaires pour
+ certaines configurations particulières, comme décrit ci-dessous.</p>
+
+ <ul>
+ <li>La directive <directive
+ module="core">DefaultType</directive> ne produit plus aucun
+ effet, si ce n'est d'émettre un avertissement si elle est
+ définie à une valeur autre que <code>none</code>. D'autres
+ directives de configuration la remplacent dans la version 2.4.
+ </li>
+
+ <li><module>mod_log_config</module>: <a
+ href="modules/mod_log_config.html#formats">${cookie}C</a>
+ correspond au nom du cookie dans son ensemble, alors qu'avant,
+ toute sous-chaîne pouvait correspondre.</li>
+
+ <li><module>mod_dav_fs</module>: le format du fichier <directive
+ module="dav_fs">DavLockDB</directive> a changé pour les systèmes
+ avec inodes. L'ancien fichier <directive
+ module="dav_fs">DavLockDB</directive> doit être supprimé dans le
+ cadre de la mise à jour.
+ </li>
+
+ <li>La directive <directive module="core">KeepAlive</directive>
+ n'accepte que les valeurs <code>On</code> ou <code>Off</code>.
+ Avant, toute valeur autre que "Off" ou "0" était traitée comme
+ "On".</li>
+
+ <li>Les directives AcceptMutex, LockFile, RewriteLock, SSLMutex,
+ SSLStaplingMutex et WatchdogMutexPath ont été remplacées par la
+ directive unique <directive module="core">Mutex</directive>.
+ Vous devez évaluer l'impact de ces directives obsolètes dans
+ votre configuration version 2.2 afin de déterminer si elles
+ peuvent être simplement supprimées, ou si elles doivent être
+ remplacées par la directive <directive
+ module="core">Mutex</directive>.</li>
+
+ <li><module>mod_cache</module>: la directive <directive
+ module="cache">CacheIgnoreURLSessionIdentifiers</directive>
+ effectue maintenent une correspondance exacte dans la chaîne de
+ paramètres au lieu d'une correspondance partielle. Si votre
+ configuration mettait en jeu des sous-chaînes comme
+ <code>sessionid</code> pour correspondre à
+ <code>/une-application/image.gif;jsessionid=123456789</code>,
+ vous devez maintenant utiliser la chaîne de correspondance
+ complète <code>jsessionid</code>.
+ </li>
+
+ <li><module>mod_ldap</module>: la directive <directive
+ module="ldap">LDAPTrustedClientCert</directive> s'utilise
+ maintenant exclusivement au sein d'une configuration de niveau
+ répertoire. Si vous utilisez cette directive, passez en revue
+ votre configuration pour vous assurer qu'elle est bien présente
+ dans tous les contextes de répertoire nécessaires.</li>
+
+ </ul>
+ </section>
</section>
<section id="misc">
<title>Changements divers</title>
+ <ul>
+ <li><module>mod_auto_index</module>: extrait maintenant les titres
+ et affiche la description pour les fichiers .xhtml qui étaient
+ jusqu'alors ignorés.</li>
+ <li><program>htpasswd</program> utilise maintenant par défaut les
+ condensés MD5 sur toutes les plates-formes.</li>
+ </ul>
+
</section>
<section id="third-party">
<title>Modules tiers</title>
+ <p>Tous les modules tiers doivent être recompilés pour la
+ version 2.4 avant d'être chargés.</p>
+ <p>De nombreux modules tiers conçus pour la version 2.2
+ fonctionneront sans changement avec le serveur HTTP Apache
+ version 2.4. Certains nécessiterons cependant des modifications ; se
+ reporter à la vue d'ensemble <a
+ href="developer/new_api_2_4.html">Mise à jour de l'API</a>.</p>
+ </section>
+<section id="commonproblems">
+ <title>Problèmes de mise à jour courants</title>
+ <ul><li>Erreurs au démarrage :
+ <ul>
+ <li><code>Invalid command 'User', perhaps misspelled or defined by
+ a module not included in the server configuration</code> - chargez
+ le module <module>mod_unixd</module></li>
+ <li><code>Invalid command 'Require', perhaps misspelled or defined
+ by a module not included in the server configuration</code>, ou
+ <code>Invalid command 'Order', perhaps misspelled or defined by a
+ module not included in the server configuration</code> - chargez
+ le module <module>mod_access_compat</module>, ou mettez à jour
+ vers la version 2.4 les directives d'autorisation.</li>
+ <li><code>Ignoring deprecated use of DefaultType in line NN of
+ /path/to/httpd.conf</code> - supprimez la directive <directive
+ module="core">DefaultType</directive> et remplacez-la par les
+ directives de configuration appropriées.</li>
+ </ul></li>
+ <li>Erreurs de traitement des requêtes :
+ <ul>
+ <li><code>configuration error: couldn't check user: /path</code> -
+ chargez le module <module>mod_authn_core</module>.</li>
+ </ul>
+ </li>
+</ul>
</section>
</manualpage>