Commit 4820cc2e authored by Lucien Gentis's avatar Lucien Gentis
Browse files

XML updates. 


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1770508 13f79535-47bb-0310-9956-ffa450edef68
parent 065bf19e

docs/manual/mod/mod_lbmethod_bybusyness.xml.fr

+23 −23
Original line number Diff line number Diff line 
<?xml version="1.0"?>

<?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 : 1174718 -->
@@ -25,43 +25,43 @@ 
<modulesynopsis metafile="mod_lbmethod_bybusyness.xml.meta">



<name>mod_lbmethod_bybusyness</name>

<description>Algorithme de planification avec r&eacute;partition de charge de

l'attribution des requ&ecirc;tes en attente pour le module

<description>Algorithme de planification avec répartition de charge de

l'attribution des requêtes en attente pour le module

<module>mod_proxy_balancer</module></description>

<status>Extension</status>

<sourcefile>mod_lbmethod_bybusyness.c</sourcefile>

<identifier>lbmethod_bybusyness_module</identifier>

<compatibility>Dissoci&eacute; de <module>mod_proxy_balancer</module> depuis la

<compatibility>Dissocié de <module>mod_proxy_balancer</module> depuis la

version 2.3</compatibility>



<summary>

<p>Ce module ne fournit pas lui-m&ecirc;me de directive de configuration. Il

n&eacute;cessite les services de <module>mod_proxy_balancer</module>, et

fournit la m&eacute;thode de r&eacute;partition de charge <code>bybusyness</code>.</p>

<p>Ce module ne fournit pas lui-même de directive de configuration. Il

nécessite les services de <module>mod_proxy_balancer</module>, et

fournit la méthode de répartition de charge <code>bybusyness</code>.</p>

</summary>

<seealso><module>mod_proxy</module></seealso>

<seealso><module>mod_proxy_balancer</module></seealso>



<section id="busyness">



    <title>Algorithme d'attribution des requ&ecirc;tes en attente</title>

    <title>Algorithme d'attribution des requêtes en attente</title>



    <p>Activ&eacute; via <code>lbmethod=bybusyness</code>, ce planificateur

    surveille le nombre de requ&ecirc;tes assign&eacute;es &agrave; chaque processus worker

    &agrave; l'instant pr&eacute;sent. Une nouvelle requ&ecirc;te est automatiquement

    assign&eacute;e au processus worker auquel est assign&eacute; le plus petit nombre de

    requ&ecirc;tes. Ceci s'av&egrave;re utile dans le cas o&ugrave; les

    processus worker mettent en file d'attente les requ&ecirc;tes entrantes

    ind&eacute;pendamment d'Apache, et permet de s'assurer que la longueur des

    files reste raisonnable, et qu'une requ&ecirc;te est toujours assign&eacute;e au

    processus worker qui sera &agrave; m&ecirc;me de la servir le plus

    rapidement et avec une latence r&eacute;duite.</p>

    <p>Activé via <code>lbmethod=bybusyness</code>, ce planificateur

    surveille le nombre de requêtes assignées à chaque processus worker

    à l'instant présent. Une nouvelle requête est automatiquement

    assignée au processus worker auquel est assigné le plus petit nombre de

    requêtes. Ceci s'avère utile dans le cas où les

    processus worker mettent en file d'attente les requêtes entrantes

    indépendamment d'Apache, et permet de s'assurer que la longueur des

    files reste raisonnable, et qu'une requête est toujours assignée au

    processus worker qui sera à même de la servir le plus

    rapidement et avec une latence réduite.</p>



    <p>Si plusieurs processus worker s'av&egrave;rent les moins charg&eacute;s, le

    choix d'un de ces derniers est effectu&eacute; &agrave; partir des statistiques

    (et des estimations de charges) qu'utilise la m&eacute;thode de d&eacute;compte

    des requ&ecirc;tes. Au fil du temps, la distribution des t&acirc;ches finit par

    ressembler &agrave; celle de <code>byrequests</code> (tel qu'impl&eacute;ment&eacute; par

    <p>Si plusieurs processus worker s'avèrent les moins chargés, le

    choix d'un de ces derniers est effectué à partir des statistiques

    (et des estimations de charges) qu'utilise la méthode de décompte

    des requêtes. Au fil du temps, la distribution des tâches finit par

    ressembler à celle de <code>byrequests</code> (tel qu'implémenté par

    <module>mod_lbmethod_byrequests</module>).</p>



</section>

docs/manual/mod/mod_lbmethod_byrequests.xml.fr

+36 −36
Original line number Diff line number Diff line 
<?xml version="1.0"?>

<?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 : 1328329 -->
@@ -25,53 +25,53 @@ 
<modulesynopsis metafile="mod_lbmethod_byrequests.xml.meta">



<name>mod_lbmethod_byrequests</name>

<description>Algorithme de planification avec r&eacute;partition de charge du

traitement des requ&ecirc;tes pour le module

<description>Algorithme de planification avec répartition de charge du

traitement des requêtes pour le module

<module>mod_proxy_balancer</module></description>

<status>Extension</status>

<sourcefile>mod_lbmethod_byrequests.c</sourcefile>

<identifier>lbmethod_byrequests_module</identifier>

<compatibility>Dissoci&eacute; de <module>mod_proxy_balancer</module> dans la

<compatibility>Dissocié de <module>mod_proxy_balancer</module> dans la

version 2.3</compatibility>



<summary>

<p>Ce module ne fournit pas lui-m&ecirc;me de directive de configuration. Il

n&eacute;cessite les services de <module>mod_proxy_balancer</module>, et

fournit la m&eacute;thode de r&eacute;partition de charge <code>byrequests</code>.</p>

<p>Ce module ne fournit pas lui-même de directive de configuration. Il

nécessite les services de <module>mod_proxy_balancer</module>, et

fournit la méthode de répartition de charge <code>byrequests</code>.</p>

</summary>

<seealso><module>mod_proxy</module></seealso>

<seealso><module>mod_proxy_balancer</module></seealso>



<section id="requests">

    <title>Algorithme d'attribution des requ&ecirc;tes</title>

    <p>Activ&eacute; via <code>lbmethod=byrequests</code>, ce planificateur &agrave;

    &eacute;t&eacute; con&ccedil;u dans le but de distribuer les requ&ecirc;tes &agrave; tous les

    processus worker afin qu'ils traitent tous le nombre de requ&ecirc;tes

    pour lequel ils ont &eacute;t&eacute; configur&eacute;s. Il fonctionne de la mani&egrave;re

    <title>Algorithme d'attribution des requêtes</title>

    <p>Activé via <code>lbmethod=byrequests</code>, ce planificateur à

    été conçu dans le but de distribuer les requêtes à tous les

    processus worker afin qu'ils traitent tous le nombre de requêtes

    pour lequel ils ont été configurés. Il fonctionne de la manière

    suivante : </p>



    <p><dfn>lbfactor</dfn> correspond &agrave; la <em>quantit&eacute; de travail que

    <p><dfn>lbfactor</dfn> correspond à la <em>quantité de travail que

    nous attendons de ce processus worker</em>, ou en d'autres termes

    son <em>quota de travail</em>. C'est une valeur normalis&eacute;e

    repr&eacute;sentant leur part du travail &agrave; accomplir.</p>

    son <em>quota de travail</em>. C'est une valeur normalisée

    représentant leur part du travail à accomplir.</p>



    <p><dfn>lbstatus</dfn> repr&eacute;sente <em>combien il est urgent que

    <p><dfn>lbstatus</dfn> représente <em>combien il est urgent que

    ce processus worker travaille pour remplir son quota de

    travail</em>.</p>



    <p>Le <dfn>worker</dfn> est un membre du dispositif de r&eacute;partition

    de charge, en g&eacute;n&eacute;ral un serveur distant traitant un des protocoles

    support&eacute;s.</p>

    <p>Le <dfn>worker</dfn> est un membre du dispositif de répartition

    de charge, en général un serveur distant traitant un des protocoles

    supportés.</p>



    <p>On distribue &agrave; chaque processus worker son quota de travail, puis

    <p>On distribue à chaque processus worker son quota de travail, puis

    on regarde celui qui a le plus besoin de travailler

    (le plus grand lbstatus). Ce processus est alors s&eacute;lectionn&eacute; pour

    travailler, et son lbstatus diminu&eacute; de l'ensemble des quotas de

    travail que nous avons distribu&eacute;s &agrave; tous les processus. La somme de

    tous les lbstatus n'est ainsi pas modifi&eacute;e, et nous pouvons

    distribuer les requ&ecirc;tes selon nos souhaits.</p>

    (le plus grand lbstatus). Ce processus est alors sélectionné pour

    travailler, et son lbstatus diminué de l'ensemble des quotas de

    travail que nous avons distribués à tous les processus. La somme de

    tous les lbstatus n'est ainsi pas modifiée, et nous pouvons

    distribuer les requêtes selon nos souhaits.</p>



    <p>Si certains processus workers sont d&eacute;sactiv&eacute;s, les autres feront

    <p>Si certains processus workers sont désactivés, les autres feront

    l'objet d'une planification normale.</p>



    <example><pre><code>for each worker in workers
@@ -83,7 +83,7 @@ fournit la m&eacute;thode de r&eacute;partition de charge <code>byrequests</code 
candidate lbstatus -= total factor</code></pre>

    </example>



    <p>Si un r&eacute;partiteur de charge est configur&eacute; comme suit :</p>

    <p>Si un répartiteur de charge est configuré comme suit :</p>



    <table style="data">

    <tr><th>worker</th>
@@ -103,7 +103,7 @@ candidate lbstatus -= total factor</code></pre> 
        <td>0</td></tr>

    </table>



    <p>Et si <var>b</var> est d&eacute;sactiv&eacute;, la planification suivante est

    <p>Et si <var>b</var> est désactivé, la planification suivante est

    mise en oeuvre :</p>



    <table style="data">
@@ -130,7 +130,7 @@ candidate lbstatus -= total factor</code></pre> 
    <tr><td colspan="5">(repeat)</td></tr>

    </table>



    <p>C'est &agrave; dire la chronologie suivante : <var>a</var> <var>c</var>

    <p>C'est à dire la chronologie suivante : <var>a</var> <var>c</var>

    <var>d</var>

    <var>a</var> <var>c</var> <var>d</var> <var>a</var> <var>c</var>

    <var>d</var> ... Veuillez noter que :</p>
@@ -148,7 +148,7 @@ candidate lbstatus -= total factor</code></pre> 
        <td>25</td></tr>

    </table>



    <p>A le m&ecirc;me effet que :</p>

    <p>A le même effet que :</p>



    <table style="data">

    <tr><th>worker</th>
@@ -163,8 +163,8 @@ candidate lbstatus -= total factor</code></pre> 
        <td>1</td></tr>

    </table>



    <p>Ceci est d&ucirc; au fait que toutes les valeurs de <dfn>lbfactor</dfn>

    sont normalis&eacute;es et &eacute;valu&eacute;es en fonction des autres. Avec :</p>

    <p>Ceci est dû au fait que toutes les valeurs de <dfn>lbfactor</dfn>

    sont normalisées et évaluées en fonction des autres. Avec :</p>



    <table style="data">

    <tr><th>worker</th>
@@ -178,9 +178,9 @@ candidate lbstatus -= total factor</code></pre> 
    </table>



    <p>le processus <var>b</var> va, en moyenne, se voir assigner 4 fois

    plus de requ&ecirc;tes que <var>a</var> et <var>c</var>.</p>

    plus de requêtes que <var>a</var> et <var>c</var>.</p>



    <p>La configuration suivante, asym&eacute;trique, fonctionne comme on peut

    <p>La configuration suivante, asymétrique, fonctionne comme on peut

    s'y attendre :</p>



    <table style="data">
@@ -224,8 +224,8 @@ candidate lbstatus -= total factor</code></pre> 
    <tr><td colspan="3">(repeat)</td></tr>

    </table>



    <p>Apr&egrave;s 10 distributions, la planification se r&eacute;p&egrave;te et 7

    <var>a</var> sont s&eacute;lectionn&eacute;s avec 3 <var>b</var> intercal&eacute;s.</p>

    <p>Après 10 distributions, la planification se répète et 7

    <var>a</var> sont sélectionnés avec 3 <var>b</var> intercalés.</p>

</section>



</modulesynopsis>

docs/manual/mod/mod_lbmethod_bytraffic.xml.fr

+24 −24
Original line number Diff line number Diff line 
<?xml version="1.0"?>

<?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 : 1174747 -->
@@ -25,38 +25,38 @@ 
<modulesynopsis metafile="mod_lbmethod_bytraffic.xml.meta">



<name>mod_lbmethod_bytraffic</name>

<description>Algorithme de planification avec r&eacute;partition de charge en

<description>Algorithme de planification avec répartition de charge en

fonction d'un niveau de trafic pour le module

<module>mod_proxy_balancer</module></description>

<status>Extension</status>

<sourcefile>mod_lbmethod_bytraffic.c</sourcefile>

<identifier>lbmethod_bytraffic_module</identifier>

<compatibility>Dissoci&eacute; de <module>mod_proxy_balancer</module> depuis la

<compatibility>Dissocié de <module>mod_proxy_balancer</module> depuis la

version 2.3</compatibility>



<summary>

<p>Ce module ne fournit pas lui-m&ecirc;me de directive de configuration. Il

n&eacute;cessite les services de <module>mod_proxy_balancer</module>, et

fournit la m&eacute;thode de r&eacute;partition de charge <code>bytraffic</code>.</p>

<p>Ce module ne fournit pas lui-même de directive de configuration. Il

nécessite les services de <module>mod_proxy_balancer</module>, et

fournit la méthode de répartition de charge <code>bytraffic</code>.</p>

</summary>

<seealso><module>mod_proxy</module></seealso>

<seealso><module>mod_proxy_balancer</module></seealso>



<section id="traffic">

    <title>Algorithme de r&eacute;partition en fonction d'un certain

    <title>Algorithme de répartition en fonction d'un certain

    trafic</title>

    <p>Activ&eacute; via <code>lbmethod=bytraffic</code>, l'id&eacute;e directrice de

    ce planificateur est similaire &agrave; celle de la m&eacute;thode reposant sur le

    nombre de requ&ecirc;tes, avec les diff&eacute;rences suivantes :</p>

    <p>Activé via <code>lbmethod=bytraffic</code>, l'idée directrice de

    ce planificateur est similaire à celle de la méthode reposant sur le

    nombre de requêtes, avec les différences suivantes :</p>



    <p><dfn>lbfactor</dfn> repr&eacute;sente la <em>quantit&eacute; de trafic, en

    octets, que nous voulons voir trait&eacute;e par le processus</em>. Il

    s'agit l&agrave; aussi d'une valeur normalis&eacute;e repr&eacute;sentant la part de

    travail &agrave; effectuer par le processus, mais au lieu de se baser sur

    un nombre de requ&ecirc;tes, on prend en compte la quantit&eacute; de trafic que

    ce processus a trait&eacute;.</p>

    <p><dfn>lbfactor</dfn> représente la <em>quantité de trafic, en

    octets, que nous voulons voir traitée par le processus</em>. Il

    s'agit là aussi d'une valeur normalisée représentant la part de

    travail à effectuer par le processus, mais au lieu de se baser sur

    un nombre de requêtes, on prend en compte la quantité de trafic que

    ce processus a traité.</p>



    <p>Si un r&eacute;partiteur est configur&eacute; comme suit :</p>

    <p>Si un répartiteur est configuré comme suit :</p>



    <table style="data">

    <tr><th>worker</th>
@@ -70,14 +70,14 @@ fournit la m&eacute;thode de r&eacute;partition de charge <code>bytraffic</code> 
    </table>



    <p>Cela signifie que nous souhaitons que <var>b</var> traite 2 fois

    plus d'octets que <var>a</var> ou <var>c</var>. Cela n'entra&icirc;ne pas

    n&eacute;cessairement que <var>b</var> va traiter deux fois plus de

    requ&ecirc;tes, mais qu'il va traiter deux fois plus de trafic en termes

    d'entr&eacute;es/sorties. A cet effet, les tailles de la requ&ecirc;te et de sa

    r&eacute;ponse assocci&eacute;e sont prises en compte par l'algorithme de

    s&eacute;lection et d'&eacute;valuation du trafic.</p>

    plus d'octets que <var>a</var> ou <var>c</var>. Cela n'entraîne pas

    nécessairement que <var>b</var> va traiter deux fois plus de

    requêtes, mais qu'il va traiter deux fois plus de trafic en termes

    d'entrées/sorties. A cet effet, les tailles de la requête et de sa

    réponse assocciée sont prises en compte par l'algorithme de

    sélection et d'évaluation du trafic.</p>



    <p>Note : les octets en entr&eacute;e sont &eacute;valu&eacute;s avec la m&ecirc;me pond&eacute;ration

    <p>Note : les octets en entrée sont évalués avec la même pondération

    que les octets en sortie.</p>



</section>

docs/manual/mod/mod_lbmethod_heartbeat.xml.fr

+15 −15
Original line number Diff line number Diff line 
<?xml version="1.0"?>

<?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 : 1347906 -->
@@ -25,8 +25,8 @@ 
<modulesynopsis metafile="mod_lbmethod_heartbeat.xml.meta">



<name>mod_lbmethod_heartbeat</name>

<description>Algorithme d'ordonnancement de r&eacute;partition de charge pour

<module>mod_proxy_balancer</module> bas&eacute; sur le comptage de trafic Heartbeat</description>

<description>Algorithme d'ordonnancement de répartition de charge pour

<module>mod_proxy_balancer</module> basé sur le comptage de trafic Heartbeat</description>

<status>Experimental</status>

<sourcefile>mod_lbmethod_heartbeat.c</sourcefile>

<identifier>lbmethod_heartbeat_module</identifier>
@@ -34,16 +34,16 @@ 


<summary>

    <p>lbmethod=heartbeat utilise les services du module

    <module>mod_heartmonitor</module> pour r&eacute;partir la charge entre les

    serveurs d'origine qui fournissent des donn&eacute;es heartbeat via le

    <module>mod_heartmonitor</module> pour répartir la charge entre les

    serveurs d'origine qui fournissent des données heartbeat via le

    module <module>mod_heartbeat</module>.</p>



<p>Son algorithme de r&eacute;partition de charge favorise les serveurs dont la

capacit&eacute; de traitement moyenne r&eacute;partie dans le temps est la plus

importante, mais il ne s&eacute;lectionne pas forc&eacute;ment le serveur qui pr&eacute;sente

la disponibilit&eacute; instantan&eacute;e la plus importante. Les serveurs qui ne

poss&egrave;dent aucun client actif sont p&eacute;nalis&eacute;s, car ils sont consid&eacute;r&eacute;s

comme non enti&egrave;rement initialis&eacute;s.</p>

<p>Son algorithme de répartition de charge favorise les serveurs dont la

capacité de traitement moyenne répartie dans le temps est la plus

importante, mais il ne sélectionne pas forcément le serveur qui présente

la disponibilité instantanée la plus importante. Les serveurs qui ne

possèdent aucun client actif sont pénalisés, car ils sont considérés

comme non entièrement initialisés.</p>

</summary>



<seealso><module>mod_proxy</module></seealso>
@@ -53,7 +53,7 @@ comme non enti&egrave;rement initialis&eacute;s.</p> 


<directivesynopsis>

<name>HeartbeatStorage</name>

<description>Indique le chemin permettant de lire les donn&eacute;es

<description>Indique le chemin permettant de lire les données

heartbeat</description>

<syntax>HeartbeatStorage <var>chemin-fichier</var></syntax>

<default>HeartbeatStorage logs/hb.dat</default>
@@ -61,9 +61,9 @@ heartbeat</description> 


<usage>

    <p>La directive <directive>HeartbeatStorage</directive> permet de

    sp&eacute;cifier le chemin d'acc&egrave;s aux donn&eacute;es heartbeat. Ce fichier texte

    n'est utilis&eacute; que si le module <module>mod_slotmem_shm</module>

    n'est pas charg&eacute;.</p>

    spécifier le chemin d'accès aux données heartbeat. Ce fichier texte

    n'est utilisé que si le module <module>mod_slotmem_shm</module>

    n'est pas chargé.</p>

</usage>

</directivesynopsis>

</modulesynopsis>