Commit 4cc2016f authored by Lucien Gentis's avatar Lucien Gentis
Browse files

XML updates.


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1803655 13f79535-47bb-0310-9956-ffa450edef68
parent 139873d8
Loading
Loading
Loading
Loading
+33 −27
Original line number Diff line number Diff line
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision: 1802040:1803254 (outdated) -->
<!-- English Revision: 1803254 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->

@@ -218,8 +218,7 @@ ProxyVia On

      <p>Les deux workers par défaut possèdent une configuration figée
      et seront utilisés si aucun autre worker ne correspond à la
      requête. Ils n'utilisent ni les jeux de connexions (connection
      pooling), ni les
      requête. Ils ne réutilisent pas les connexions et n'utilisent pas les
      connexions HTTP persistantes (Keep-Alive). En effet, les
      connexions TCP vers le serveur original sont fermées et ouvertes
      pour chaque requête.</p>
@@ -347,10 +346,10 @@ ProxyPass "/examples" "http://backend.example.com/examples" timeout=10

      <note><title>Résolution DNS pour les domaines originaux</title>
      <p>La résolution DNS s'effectue lorsque le socket vers le
      domaine original est créé pour la première fois. Lorsque le pooling de
      connexions est utilisé, chaque domaine d'arrière-plan n'est résolu qu'une
      seule fois pour chaque processus enfant, et cette résolution est réutilisée
      pour toutes les connexions ultérieures jusqu'à ce que le processus enfant
      domaine original est créé pour la première fois. Lorsque la réutilisation
      des connexions est activée, chaque domaine d'arrière-plan n'est résolu qu'une
      seule fois pour chaque processus enfant, et cette résolution est mise en
      cache pour toutes les connexions ultérieures jusqu'à ce que le processus enfant
      soit recyclé. Ce comportement doit être pris en considération lorsqu'on
      planifie des tâches de maintenance du DNS impactant les domaines
      d'arrière-plan. Veuillez aussi vous reporter aux paramètres de la
@@ -998,7 +997,10 @@ de la version 2.4.7 du serveur HTTP Apache</compatibility>
    chemin virtuel local ; <var>url</var> est une URL partielle pour le
    serveur distant et ne doit pas contenir de chaîne d'arguments.</p>

    <note><strong>Note : </strong>Cette directive n'est pas supportée au sein
    <note>Il est fortement recommandé de revoir le concept de <a
    href="#workers">Worker</a> avant d'aller plus loin.</note>

    <note>Cette directive n'est pas supportée au sein
    des sections <directive type="section" module="core">Directory</directive>
    et <directive type="section" module="core">Files</directive>.</note>

@@ -1136,23 +1138,23 @@ ProxyPass "/mirror/foo" "http://backend.example.com"
    <code>clé=valeur</code> dont la description fait l'objet du tableau
    ci-dessous.</p>

    <p>Par défaut, mod_proxy permet et met en réserve le nombre maximum
    de connexions pouvant être utilisées simultanément par le processus
    enfant concerné du serveur web. Le paramètre <code>max</code> permet
    de réduire cette valeur par défaut. Le paramètre <code>ttl</code>,
    quant à lui, permet de définir une durée de vie optionnelle ; les
    connexions qui n'ont pas été utilisées pendant au moins
    <code>ttl</code> secondes seront fermées. <code>ttl</code> permet
    aussi d'empêcher l'utilisation d'une connexion susceptible d'être
    fermée suite à une fin de vie de connexion persistante sur le
    serveur d'arrière-plan.</p>

    <p>Le groupement de connexions est maintenu au niveau de chaque
    processus enfant du serveur web, et <code>max</code>, ainsi que les
    autres paramètres, 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>
    <note type="warning"><title>Nombre maximum de connexions vers
    l'arrière-plan</title> 
    <p>Par défaut, mod_proxy permet et met en réserve le
    nombre maximum de connexions pouvant être utilisées simultanément par le
    processus enfant concerné du serveur web. Le paramètre <code>max</code>
    permet de réduire cette valeur par défaut. Le jeu de connexions est maintenu
    au niveau de chaque processus enfant du serveur web, <code>max</code> et les
    autres réglages n'étant pas coordonnés entre ces différents processus, sauf
    bien entendu lorsqu'un seul processus enfant n'est autorisé par la
    configuration ou le MPM utilisé.</p> </note>
    
    <p>Le paramètre <code>ttl</code>, quant à lui, permet de définir une durée
    de vie optionnelle ; les connexions qui n'ont pas été utilisées pendant au
    moins <code>ttl</code> secondes seront fermées. <code>ttl</code> permet
    aussi d'empêcher l'utilisation d'une connexion susceptible d'être fermée
    suite à une fin de vie de connexion persistante sur le serveur
    d'arrière-plan.</p>

    <example><title>Exemple</title>
    <highlight language="config">
@@ -1160,7 +1162,7 @@ ProxyPass "/mirror/foo" "http://backend.example.com"
	</highlight>
    </example>

    <table border="2"><tr><th>Paramètres de BalancerMember</th></tr></table>
    <table border="2"><tr><th>Paramètres du worker (directive BalancerMember)</th></tr></table>
    <table>
    <tr><th>Paramètre</th>
        <th>Défaut</th>
@@ -1217,7 +1219,11 @@ ProxyPass "/mirror/foo" "http://backend.example.com"
	serveur d'arrière-plan (quelque soit le protocole) interrompt
	des connexions de manière silencieuse, ou lorsque le serveur
	d'arrière-plan lui-même est accessible par rotation de DNS
	(round-robin DNS). Pour désactiver la réutilisation du jeu de
	(round-robin DNS). Lorsque la réutilisation des connexions est activée,
	chaque domaine d'arrière-plan n'est résolu (via une requête DNS) qu'une
	seule fois par chaque processus enfant et mis en cache pour toutes les
	connexions ultérieures jusqu'au recyclage du processus concerné.	
	Pour désactiver la réutilisation du jeu de
	connexions, définissez cette clé à <code>On</code>.
    </td></tr>
    <tr><td>enablereuse</td>
+5 −1
Original line number Diff line number Diff line
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision: 1731532:1803313 (outdated) -->
<!-- English Revision: 1803313 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->

@@ -66,6 +66,10 @@ la répartition de charge</description>
    </note>
</summary>
<seealso><module>mod_proxy</module></seealso>
<seealso><directive module="mod_proxy">BalancerMember</directive></seealso>
<seealso><directive module="mod_proxy">BalancerGrowth</directive></seealso>
<seealso><directive module="mod_proxy">BalancerPersist</directive></seealso>
<seealso><directive module="mod_proxy">BalancerInherit</directive></seealso>

<section id="scheduler">
    <title>L'algorithme de planification de la répartition de
+5 −1
Original line number Diff line number Diff line
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision: 1793934:1803313 (outdated) -->
<!-- English Revision: 1803313 -->
<!-- French translation : Lucien GENTIS -->

<!--
@@ -81,6 +81,10 @@ dynamique inverse de masse</description>

</summary>
<seealso><module>mod_proxy</module></seealso>
<seealso><directive module="mod_proxy">BalancerMember</directive></seealso>
<seealso><directive module="mod_proxy">BalancerGrowth</directive></seealso>
<seealso><directive module="mod_proxy">BalancerPersist</directive></seealso>
<seealso><directive module="mod_proxy">BalancerInherit</directive></seealso>

<directivesynopsis>
<name>ProxyExpressEnable</name>
+2 −2
Original line number Diff line number Diff line
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision: 1802336:1803171 (outdated) -->
<!-- English Revision: 1803171 -->
<!-- French translation : Lucien GENTIS -->

<!--
@@ -91,7 +91,7 @@ ProxyPass "/mon_appli/" "fcgi://localhost:4000/"
    que chemin du système de fichiers pour l'exécution du démon PHP-FPM.
    L'URL de la requête est implicitement ajoutée au second paramètre.
    PHP-FPM est à l'écoute de l'hôte et du port qui
    suivent fcgi://. La conservation des connexions est activée.</p>
    suivent fcgi://. La conservation/réutilisation des connexions est activée.</p>
    <example><title>PHP-FPM</title>
    <highlight language="config">
ProxyPassMatch "^/myapp/.*\.php(/.*)?$" "fcgi://localhost:9000/var/www/" enablereuse=on
+2 −2
Original line number Diff line number Diff line
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision: 1799968:1803171 (outdated) -->
<!-- English Revision: 1803171 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->

@@ -580,7 +580,7 @@ local.</p>
      persistantes, ce qui signifie que vous obtiendrez des performances meilleurs si vous utilisez
      <directive module="mod_proxy">ProxyPass</directive> ou <directive module="mod_proxy">ProxyPassMatch</directive>.</p>
      <p>Ceci est du au fait que ce drapeau induit l'utilisation du worker par défaut, qui
      ne gère pas la mise en commun des connexions.</p>
      ne gère pas la mise en commun et la réutilisation des connexions.</p>
      <p>Partout où cela est possible, préférez l'utilisation de ces directives.</p>
</note>