svn commit: r1774893 - /httpd/httpd/trunk/docs/manual/mod/event.xml.fr

[lg...@apache.org]

Author: lgentis
Date: Sun Dec 18 15:00:08 2016
New Revision: 1774893

URL: http://svn.apache.org/viewvc?rev=1774893&view=rev
Log:
XML update.

Modified:
    httpd/httpd/trunk/docs/manual/mod/event.xml.fr

Modified: httpd/httpd/trunk/docs/manual/mod/event.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/event.xml.fr?rev=1774893&r1=1774892&r2=1774893&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/event.xml.fr [utf-8] (original)
+++ httpd/httpd/trunk/docs/manual/mod/event.xml.fr [utf-8] Sun Dec 18 15:00:08 2016
@@ -1,7 +1,7 @@
 <?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: 1742029:1772512 (outdated) -->
+<!-- English Revision: 1772512 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -145,6 +145,89 @@ propose le MPM <module>worker</module>,
 
     </section>
 
+    <section id="graceful-close"><title>Arr�t de processus en douceur et
+    utilisation du scoreboard</title>
+        <p>Ce MPM pr�sentait dans le pass� des limitations de mont�e en
+	puissance qui
+	provoquaient l'erreur suivante : "<strong>scoreboard is full, not at
+	MaxRequestWorkers</strong>". La directive <directive
+	module="mpm_common">MaxRequestWorkers</directive> permet de limiter le
+	nombre de requ�tes pouvant �tre servies simultan�ment � un moment donn�
+	ainsi que le nombre de processus autoris�s (<directive
+	module="mpm_common">MaxRequestWorkers</directive> / <directive
+	module="mpm_common">ThreadsPerChild</directive>), alors que le
+	scoreboard repr�sente l'ensemble des processus en cours d'ex�cution et
+	l'�tat de leurs threads de travail. Si le scoreboard est plein
+	(autrement dit si aucun des threads n'est dans un �tat inactif) et si le
+	nombre de requ�tes actives servies est inf�rieur � <directive
+	module="mpm_common">MaxRequestWorkers</directive>, cela signifie que
+	certains d'entre eux bloquent les nouvelles requ�tes qui pourraient �tre
+	servies et sont en l'occurrence mises en attente (dans la limite de la
+	valeur impos�e par la directive <directive
+	module="mpm_common">ListenBacklog</directive>). La plupart du temps, ces
+	threads sont bloqu�s dans un �tat d'arr�t en douceur car ils attendent
+	de terminer leur travail sur une connexion TCP pour s'arr�ter et ainsi lib�rer
+	une entr�e dans le scoreboard (par exemple dans le cas du traitement des
+	requ�tes de longue dur�e, des clients lents ou des connexions en
+	keep-alive). Voici deux sc�narios courants :</p>
+        <ul>
+            <li>Pendant un <a href="../stopping.html#graceful">graceful
+	    restart</a>. Le processus parent demande � tous ses processus
+	    enfants de terminer leur travail et de s'arr�ter pendant qu'il
+	    recharge la configuration et lance de nouveaux processus. Si les
+	    processus existants continuent de s'ex�cuter pendant un certain
+	    temps avant de s'arr�ter, le scoreboard sera partiellement occup�
+	    jusqu'� ce que les entr�es correspondantes soient lib�r�es.
+            </li>
+            <li>Lorsque la charge du serveur diminue suffisamment pour que httpd
+	    commence � stopper certains processus (par exemple pour respecter la
+	    valeur de la directive <directive
+	    module="mpm_common">MaxSpareThreads</directive>). Cette situation
+	    est probl�matique car lorsque la charge augmente � nouveau, httpd va
+	    essayer de lancer de nouveaux processus. Si cette situation se
+	    r�p�te, le nombre de processus peut augmenter sensiblement,
+	    aboutissant � un m�lange d'anciens processus tentant de s'arr�ter et
+	    de nouveaux processus tentant d'effectuer un travail quelconque.
+            </li>
+        </ul>
+        <p>A partir de la version 2.4.24, mpm-event est plus intelligent et peut
+	traiter les arr�ts graceful de mani�re plus efficace. Voici certaines de
+	ces am�liorations :</p>
+        <ul>
+            <li>Utilisation de toutes les entr�es du scoreboard dans la limite
+	    de la valeur d�finie par <directive
+	    module="mpm_common">ServerLimit</directive>. Les directives
+	    <directive module="mpm_common">MaxRequestWorkers</directive> et
+	    <directive module="mpm_common">ThreadsPerChild</directive>
+	    permettent de limiter le nombre de processus actifs, alors que la
+	    directive <directive module="mpm_common">ServerLimit</directive>
+	    prend aussi en compte les proccessus en arr�t graceful pour
+	    permettre l'utilisation d'entr�es suppl�mentaires du scoreboard en
+	    cas de besoin. L'id�e consiste � utiliser <directive
+	    module="mpm_common">ServerLimit</directive> pour indiquer � httpd
+	    conbien de processus suppl�mentaires seront tol�r�s avant
+	    d'atteindre les limites impos�es par les ressources du syst�me.
+            </li>
+            <li>Les processus en arr�t graceful doivent fermer leurs connexions
+	    en keep-alive.</li>
+            <li>Lors d'un arr�t graceful, s'il y a plus de threads de travail en
+	    cours d'ex�cution que de connexions ouvertes pour un processus
+	    donn�, ces threads sont arr�t�s afin de lib�rer les ressources plus
+	    vite (ce qui peut s'av�rer n�cessaire pour lancer de nouveaux
+	    processus).</li>
+            <li>Si le scoreboard est plein, emp�che d'arr�ter d'autres processus
+	    en mode graceful afin de r�duire la charge jusqu'� ce que tous les
+	    anciens processus soient arr�t�s (sinon la situation empirerait lors
+	    d'une remont�e en charge).</li>
+        </ul>
+        <p>Le comportement d�crit dans le dernier point est bien visible via
+	<module>mod_status</module> dans la table des connexions avec les deux
+	nouvelles colonnes "Slot" et "Stopping". La premi�re indique le PID et
+	la seconde si le processus est en cours d'arr�t ou non ; l'�tat
+	suppl�mentaire "Yes (old gen)" indique un processus encore en ex�cution
+	apr�s un red�marrage graceful.</p>
+    </section>
+
     <section id="limitations"><title>Limitations</title>
         <p>La gestion am�lior�e des connexions peut ne pas fonctionner pour
 	certains filtres de connexion qui se sont d�clar�s eux-m�mes