httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jfcl...@apache.org
Subject svn commit: r566566 [2/2] - in /httpd/httpd/branches/2.2.x/docs/manual: handler.html.fr handler.xml.fr invoking.html.fr invoking.xml.fr mpm.html.fr mpm.xml.fr new_features_2_2.html.fr new_features_2_2.xml.fr stopping.html.fr stopping.xml.fr
Date Thu, 16 Aug 2007 08:44:34 GMT
Added: httpd/httpd/branches/2.2.x/docs/manual/new_features_2_2.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/new_features_2_2.xml.fr?view=auto&rev=566566
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/new_features_2_2.xml.fr (added)
+++ httpd/httpd/branches/2.2.x/docs/manual/new_features_2_2.xml.fr Thu Aug 16 01:44:33 2007
@@ -0,0 +1,296 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
+<!-- LastChangedRevision English document : 420990 -->
+<!-- French translation : Lucien GENTIS -->
+<!-- $LastChangedRevision: 2007062301 $ -->
+
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements.  See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<manualpage metafile="new_features_2_2.xml.meta">
+
+<title>Aper&ccedil;u des nouvelles fonctionnalit&eacute;s dans Apache 2.2</title>
+
+<summary>
+  <p>Ce document d&eacute;crit quelques uns des changements principaux entre
+     les versions 2.0 et 2.2 du serveur HTTP Apache. Pour les
+     nouvelles fonctionnalit&eacute;s ajout&eacute;es depuis la version 1.3, se
+     r&eacute;f&eacute;rer au document
+     <a href="new_features_2_0.html">2.0 new features</a>.</p>
+</summary>
+
+  <section id="core">
+    <title>Am&eacute;liorations du syst&egrave;me de base</title>
+    <dl>
+
+      <dt>Authn/Authz</dt>
+      <dd>Les modules d'authentification et d'autorisation int&eacute;gr&eacute;s
+	ont &eacute;t&eacute; refondus. Le nouveau module
+	<module>mod_authn_alias</module> permet de
+	simplifier consid&eacute;rablement certaines configurations d'authentification.
+          Voir <a href="#module">modification des noms de modules</a>,
+	  et
+	  <a href="#developer">les changements pour le d&eacute;veloppeur</a>
+	  pour plus d'informations sur les cons&eacute;quences de ces
+	  changements pour les utilisateurs et les d&eacute;veloppeurs de
+	  modules.</dd>
+
+      <dt>Mise en cache</dt>
+      <dd><module>mod_cache</module>, <module>mod_disk_cache</module>, et
+          <module>mod_mem_cache</module> ont subi de nombreuses
+	  modifications, et l'on consid&egrave;re qu'ils ont maintenant atteint
+	  un degr&eacute; de qualit&eacute; suffisant pour leur mise en production. Le programme
+	  <program>htcacheclean</program> a &eacute;t&eacute; ajout&eacute; afin de rendre
+	  plus propre la configuration du module
+	  <module>mod_disk_cache</module>.</dd>
+
+      <dt>Configuration</dt>
+      <dd>L'agencement de la configuration par d&eacute;faut a &eacute;t&eacute; simplifi&eacute;
+      	et modularis&eacute;. Les portions de configuration qui peuvent &ecirc;tre
+	utilis&eacute;es pour activer des fonctionnalit&eacute;s courantes sont
+	maintenant int&eacute;gr&eacute;es &agrave; Apache, et peuvent &ecirc;tre facilement
+	ajout&eacute;es &agrave; la configuration principale du serveur.</dd>
+
+      <dt>Arr&ecirc;t en douceur</dt>
+      <dd>Les modules MPM <module>prefork</module>,
+        <module>worker</module> et <module>event</module> permettent
+	maintenant l'arr&ecirc;t en douceur de <program>httpd</program>
+          au moyen du signal
+          <a href="stopping.html#gracefulstop"><code>graceful-stop</code></a>.
+	  La directive <directive module="mpm_common"
+	  >GracefulShutdownTimeout</directive> a &eacute;t&eacute; ajout&eacute;e dans le but
+	  de sp&eacute;cifier un d&eacute;lai optionnel, apr&egrave;s lequel
+          <program>httpd</program> s'arr&ecirc;tera quel que soit le statut
+          des requ&ecirc;tes en cours.</dd>
+
+      <dt>Mise en oeuvre du proxy</dt>
+      <dd>Le nouveau module <module>mod_proxy_balancer</module> fournit
+          des services de r&eacute;partition de charge (load balancing) pour le
+	  module <module>mod_proxy</module>.
+          Le nouveau module <module>mod_proxy_ajp</module> ajoute le
+	  support pour le
+          <code>Protocole JServ de Apache version 1.3</code> qu'utilise
+          <a href="http://jakarta.apache.org/tomcat/">Apache Tomcat</a>.</dd>
+
+      <dt>Mise &agrave; jour de la biblioth&egrave;que des expressions rationnelles</dt>
+      <dd>La version 5.0 de la
+          <a href="http://www.pcre.org/">Perl Compatible Regular Expression
+          Library</a> (PCRE) est maintenant disponible.
+	  <program>httpd</program> peut &ecirc;tre configur&eacute; pour utiliser une
+	  PCRE choisie en passant l'option <code>--with-pcre</code> au
+	  script configure.</dd>
+
+      <dt>Filtrage intelligent</dt>
+      <dd>Le module <module>mod_filter</module> permet la configuration
+          dynamique de la cha&icirc;ne de filtrage en sortie. Il permet
+	  d'ins&eacute;rer des filtres conditionnels bas&eacute;s sur toute
+	  requ&ecirc;te, en-t&ecirc;te de r&eacute;ponse ou variable
+	  d'environnement, et fait table rase des probl&egrave;mes de d&eacute;pendances
+	  et d'ordonnancement rencontr&eacute;s avec l'architecture 2.0.</dd>
+
+      <dt>Support des gros fichiers</dt>
+
+      <dd>httpd supporte maintenant les fichiers d'une taille sup&eacute;rieure
+      &agrave; 2GB sur les syst&egrave;mes 32 bits UNIX modernes.  Le support des
+      corps de requ&ecirc;te d'une taille sup&eacute;rieure &agrave; 2GB a aussi &eacute;t&eacute;
+      ajout&eacute;.</dd>
+
+      <dt>Module MPM Event</dt>
+      <dd>Le module MPM <module>event</module> utilise un thread s&eacute;par&eacute;
+      	pour g&eacute;rer les requ&ecirc;tes "Keep alive" et accepter des connexions.
+	Les requ&ecirc;tes "Keep alive" requ&eacute;raient traditionnellement un
+	processus httpd d&eacute;di&eacute; pour leur gestion. Ce processus d&eacute;di&eacute;
+	ne pouvait plus &ecirc;tre r&eacute;utilis&eacute; jusqu'&agrave; ce que le d&eacute;lai "Keep Alive"
+          soit &eacute;coul&eacute;.</dd>
+
+      <dt>Support des bases de donn&eacute;es SQL</dt>
+      <dd>Le module <p><module>mod_dbd</module>, associ&eacute; &agrave; l'environnement
+      	apr_dbd, fournit le support SQL direct aux modules
+	qui en ont besoin.  Supporte la mise en commun des connexions
+          dans les modules MPM thread&eacute;s.</p>
+	  <p><strong>Utilisateurs Windows</strong> : veuillez noter que ce
+	  support n'est pas encore inclus dans l'impl&eacute;mentation Windows
+	  standard.  Si vous l'utilisez sur la plate-forme
+	  Windows, merci de nous faire savoir comment vous vous y
+	  prenez.</p>
+	  </dd>
+
+    </dl>
+  </section>
+
+  <section id="module">
+    <title>Am&eacute;liorations des modules</title>
+    <dl>
+      <dt>Authn/Authz</dt>
+      <dd>Les modules du r&eacute;pertoire aaa ont &eacute;t&eacute; renomm&eacute;s et fournissent
+          un support am&eacute;lior&eacute; pour la m&eacute;thode d'authentification <strong>digest</strong>.  Par exemple, mod_auth
+          est maintenant scind&eacute; en deux modules : <module>mod_auth_basic</module> et
+          <module>mod_authn_file</module>; mod_auth_dbm s'appelle maintenant
+          <module>mod_authn_dbm</module>; mod_access a &eacute;t&eacute; renomm&eacute; en
+          <module>mod_authz_host</module>.  Est &eacute;galement apparu le nouveau module
+          <module>mod_authn_alias</module> qui simplifie
+          certaines configurations d'authentification.
+      </dd>
+
+      <dt><module>mod_authnz_ldap</module></dt>
+      <dd>Ce module est un portage de la version 2.0 du module
+          <code>mod_auth_ldap</code> vers la version 2.2 du framework
+	  <code>Authn/Authz</code>.
+	  Les nouvelles fonctionnalit&eacute;s comprennent l'utilisation des valeurs
+	  d'attributs LDAP et des filtres de recherche avanc&eacute;s dans la
+          directive <directive module="core">Require</directive>.</dd>
+
+      <dt><module>mod_authz_owner</module></dt>
+      <dd>Ce nouveau module propose une gestion des droits d'acc&egrave;s aux ressources web selon leur appartenance
+      &agrave; un utilisateur au niveau du syst&egrave;me de fichiers.</dd>
+
+      <dt><module>mod_version</module></dt>
+      <dd>Ce nouveau module permet de d&eacute;finir des blocs de configuration activables selon le num&eacute;ro de version du serveur en fonctionnement.</dd>
+
+      <dt><module>mod_info</module></dt>
+      <dd>Un nouvel argument <code>?config</code> a &eacute;t&eacute; ajout&eacute;, qui permettra d'afficher
+          les directives de configuration telles qu'elles sont interpr&eacute;t&eacute;es
+	  par Apache, y compris le nom de fichier et le num&eacute;ro de ligne.
+	  Le module montre aussi l'ordre des point d'entr&eacute;e de traitement d'une
+	  requ&ecirc;te (request hooks) ainsi que des informations de construction
+	  suppl&eacute;mentaires, d'une mani&egrave;re similaire &agrave; <code>httpd -V</code>.</dd>
+
+      <dt><module>mod_ssl</module></dt>
+      <!-- Need Info on SSLEngine Support? -->
+      <dd>Le support de <a href="http://www.ietf.org/rfc/rfc2817.txt"
+      	>RFC 2817</a>, a &eacute;t&eacute; ajout&eacute;, ce qui permet de passer d'une
+	connexion en clair au cryptage TLS.</dd>
+
+      <dt><module>mod_imagemap</module></dt>
+      <dd>mod_imap a &eacute;t&eacute; renomm&eacute; en <module>mod_imagemap</module> afin
+      d'&eacute;viter une confusion pour les utilisateurs.</dd>
+    </dl>
+
+  </section>
+
+  <section id="programs">
+    <title>Am&eacute;liorations des programmes</title>
+    <dl>
+      <dt><program>httpd</program></dt>
+      <dd>Une nouvelle option de ligne de commande <code>-M</code>
+     a &eacute;t&eacute; ajout&eacute;e, qui fournit la liste de tous les modules charg&eacute;s
+     en fonction de la configuration r&eacute;elle. &Agrave; la diff&eacute;rence de l'option
+     <code>-l</code>, cette liste inclut les Objets Dynamiques Partag&eacute;s
+     (DSOs) charg&eacute;s par l'interm&eacute;diaire du module
+     <module>mod_so</module>.</dd>
+      <dt><program>httxt2dbm</program></dt>
+      <dd>Un nouveau programme servant &agrave; g&eacute;n&eacute;rer des fichiers dbm &agrave; partir
+      d'une source texte, &agrave; utiliser avec la directive
+      <directive module="mod_rewrite">RewriteMap</directive>
+          et le type de mise en correspondance <code>dbm</code>.</dd>
+    </dl>
+  </section>
+
+  <section id="developer">
+    <title>Changements pour le d&eacute;veloppeur de module</title>
+    <dl>
+      <dt><glossary>APR</glossary> 1.0 API</dt>
+
+      <dd>Apache 2.2 utilise l'API APR 1.0.  Toutes les fonctions et
+      symboles obsol&egrave;tes ont &eacute;t&eacute; supprim&eacute;s du code de <code>APR</code> et
+          <code>APR-Util</code>. Pour plus de d&eacute;tails, consultez le
+          <a href="http://apr.apache.org/">site web de APR</a>.</dd>
+
+      <dt>Authn/Authz</dt>
+      <dd>Les modules d'authentification et d'autorisation int&eacute;gr&eacute;s ont
+          &eacute;t&eacute; renomm&eacute;s de la mani&egrave;re suivante:
+          <ul>
+          <li>mod_auth_*  -> Modules qui impl&eacute;mentent un m&eacute;canisme
+	  	d'authentification HTTP</li>
+          <li>mod_authn_* -> Modules qui fournissent un dispositif
+	  	d'authentification en arri&egrave;re-plan</li>
+          <li>mod_authz_* -> Modules qui impl&eacute;mentent l'autorisation (ou l'acc&egrave;s)</li>
+          <li>mod_authnz_*-> Module qui impl&eacute;mentent &agrave; la fois
+	  l'authentification &amp; l'autorisation</li>
+          </ul>
+	  L'organisation des m&eacute;thodes d'authentification a &eacute;galement &eacute;t&eacute; revue, ce qui va simplifier
+	  grandement l'ajout de nouvelles m&eacute;thodes d'authentification.</dd>
+
+      <dt>Journalisation des erreurs de connexion</dt>
+
+      <dd>Une nouvelle fonction a &eacute;t&eacute; ajout&eacute;e, <code>ap_log_cerror</code>,
+      afin de pouvoir enregistrer les erreurs qui surviennent au cours de
+      la connexion du client.  Une fois enregistr&eacute;, le message inclut l'adresse IP du client.</dd>
+
+      <dt>Ajout d'une portion de code pour la v&eacute;rification de la configuration</dt>
+
+      <dd>Un nouvel &eacute;l&eacute;ment de traitement a &eacute;t&eacute; ajout&eacute;, <code>test_config</code>,
+      afin d'aider les modules qui ne veulent ex&eacute;cuter un code sp&eacute;cial
+      que si l'utilisateur passe le param&egrave;tre <code>-t</code> &agrave;
+      <program>httpd</program>.</dd>
+
+      <dt>D&eacute;finition de la taille de la pile pour les modules MPM thread&eacute;s</dt>
+
+      <dd>Une nouvelle directive a &eacute;t&eacute; ajout&eacute;e, <code>ThreadStackSize</code>
+     afin de d&eacute;finir la taille de la pile pour tous les modules MPM thread&eacute;s.
+     Ceci s'av&egrave;re n&eacute;cessaire pour certains modules tiers sur des plateformes
+     dont la taille de la pile des threads par d&eacute;faut est
+     trop petite.</dd>
+
+      <dt>Gestion de protocole pour les filtres en sortie</dt>
+
+      <dd>Par le pass&eacute;, chaque filtre devait s'assurer que les en-t&ecirc;tes de
+      r&eacute;ponse corrects &eacute;taient g&eacute;n&eacute;r&eacute;s dans la mesure o&ugrave; il les affectait.
+      Les filtres peuvent maintenant d&eacute;l&eacute;guer la gestion courante du
+      protocole au module
+          <module>mod_filter</module>, &agrave; l'aide des appels
+          <code>ap_register_output_filter_protocol</code> ou
+          <code>ap_filter_protocol</code>.</dd>
+
+      <dt>Ajout d'un &eacute;l&eacute;ment de traitement pour le processus p&egrave;re (monitor hook)</dt>
+      <dd>Ce nouvel &eacute;l&eacute;ment de traitement permet aux modules de lancer
+      des jobs r&eacute;guliers/planifi&eacute;s au niveau du processus p&egrave;re
+      (root).</dd>
+
+      <dt>Modifications de l'API de traitement des expressions r&eacute;guli&egrave;res</dt>
+
+      <dd>Le fichier d'en-t&ecirc;te <code>pcreposix.h</code> n'est plus disponible;
+      il a &eacute;t&eacute; remplac&eacute; par le nouveau fichier
+      d'en-t&ecirc;te <code>ap_regex.h</code>.  L'impl&eacute;mentation
+      POSIX.2 <code>regex.h</code> expos&eacute;e dans l'ancien fichier d'en-t&ecirc;te
+      est maintenant disponible dans l'espace de nommage <code>ap_</code>
+      depuis <code>ap_regex.h</code>.  Les appels &agrave; <code>regcomp</code>,
+      <code>regexec</code>, etc... peuvent &ecirc;tre remplac&eacute;s par des appels &agrave;
+      <code>ap_regcomp</code>, <code>ap_regcomp</code>.</dd>
+
+      <dt>Cadre d'application DBD (API pour base de donn&eacute;es SQL)</dt>
+
+      <dd><p>Avec Apache 1.x et 2.0, les modules n&eacute;cessitant un processus
+      SQL d'arri&egrave;re-plan devaient s'en charger eux-m&ecirc;mes.  En dehors du fait
+      de r&eacute;inventer la roue, ceci peut s'av&eacute;rer tr&egrave;s inefficace, par
+      exemple lorsque plusieurs modules maintiennent chacun leurs
+      propres connexions.</p>
+      <p>Apache 2.1 et sup&eacute;rieur fournissent l'API <code>ap_dbd</code> qui
+      permet la gestion des connexions &agrave; la base de donn&eacute;es (y compris
+      les strat&eacute;gies optimis&eacute;es pour les modules MPM thread&eacute;s
+      et non thread&eacute;s), tandis que APR 1.2 et sup&eacute;rieur fournissent
+      l'API <code>apr_dbd</code> qui permet l'interaction avec la
+      base de donn&eacute;es.</p>
+      <p>Les nouveaux modules DEVRAIENT d&eacute;sormais utiliser ces APIs pour
+      toutes les op&eacute;rations li&eacute;es aux bases de donn&eacute;es SQL.
+      De m&ecirc;me, les applications existantes DEVRAIENT &ecirc;tre mises &agrave; jour
+      lorsque c'est possible, soit de mani&egrave;re transparente ou sous forme
+      d'une option recommand&eacute;e &agrave; leurs utilisateurs.</p></dd>
+    </dl>
+  </section>
+</manualpage>

Added: httpd/httpd/branches/2.2.x/docs/manual/stopping.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/stopping.html.fr?view=auto&rev=566566
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/stopping.html.fr (added)
+++ httpd/httpd/branches/2.2.x/docs/manual/stopping.html.fr Thu Aug 16 01:44:33 2007
@@ -0,0 +1,275 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+              This file is generated from xml source: DO NOT EDIT
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+      -->
+<title>Arrêt et redémarrage - Serveur Apache HTTP</title>
+<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
+<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
+<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
+<link href="./images/favicon.ico" rel="shortcut icon" /></head>
+<body id="manual-page"><div id="page-header">
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
+<p class="apache">Serveur Apache HTTP Version 2.2</p>
+<img alt="" src="./images/feather.gif" /></div>
+<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.2</a></div><div id="page-content"><div id="preamble"><h1>Arrêt et redémarrage</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="./de/stopping.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
+<a href="./en/stopping.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
+<a href="./fr/stopping.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
+</div>
+
+    <p>Ce document couvre l'arrêt et le redémarrage d'Apache sur
+    les systèmes Unix et similaires. Les utilisateurs de Windows NT, 2000
+    and XP doivent consulter
+    <a href="platform/windows.html#winsvc">Exécuter Apache en tant que
+    service</a> et les utilisateurs de Windows 9x et ME doivent consulter
+    <a href="platform/windows.html#wincons">Exécuter Apache comme une
+    application de type console</a> pour plus d'informations sur le contrôle
+    d'Apache à partir de ces plateformes.</p>
+</div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#introduction">Introduction</a></li>
+<li><img alt="" src="./images/down.gif" /> <a href="#term">Arrêter immédiatement</a></li>
+<li><img alt="" src="./images/down.gif" /> <a href="#graceful">Redémarrage en douceur</a></li>
+<li><img alt="" src="./images/down.gif" /> <a href="#hup">Redémarrer immédiatement</a></li>
+<li><img alt="" src="./images/down.gif" /> <a href="#gracefulstop">Arrêt en douceur</a></li>
+</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="program"><a href="./programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="./programs/apachectl.html">apachectl</a></code></li><li><a href="invoking.html">Démarrage</a></li></ul></div>
+<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="introduction" id="introduction">Introduction</a></h2>
+
+    <p>Afin d'arrêter ou redémarrer Apache, vous devez envoyer un signal aux
+    processus <code class="program"><a href="./programs/httpd.html">httpd</a></code> en cours d'exécution.  Les signaux
+    peuvent être envoyés de deux manières.  Tout d'abord, vous pouvez
+    utiliser la commande unix <code>kill</code>
+    pour envoyer directement des signaux aux processus. Vous pouvez remarquer
+    que plusieurs processus <code class="program"><a href="./programs/httpd.html">httpd</a></code> s'exécutent sur votre
+    système, mais il vous suffit d'envoyer les signaux au processus parent,
+    dont le PID est enregistré dans le fichier précisé par la directive
+    <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>. C'est à dire que vous
+    n'aurez jamais besoin d'envoyer des signaux à aucun de ces processus,
+    sauf au processus parent. Trois types de signaux peuvent être envoyés
+    au processus parent :
+    <code><a href="#term">TERM</a></code>,
+    <code><a href="#graceful">USR1</a></code>,
+    <code><a href="#hup">HUP</a></code>, et
+    <code><a href="#gracefulstop">WINCH</a></code>, qui
+    sera décrit plus loin.</p>
+
+    <p>Pour envoyer un signal au processus parent, vous devez entrer une commande
+    du style :</p>
+
+<div class="example"><p><code>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</code></p></div>
+
+    <p>La seconde méthode permettant d'envoyer des signaux aux processus
+    <code class="program"><a href="./programs/httpd.html">httpd</a></code>
+    consiste à utiliser les options de ligne de commande <code>-k</code> :
+    <code>stop</code>,
+    <code>restart</code>, <code>graceful</code> et <code>graceful-stop</code>,
+    comme décrit ci-dessous.  Ce sont des arguments du binaire
+    <code class="program"><a href="./programs/httpd.html">httpd</a></code>, mais il est recommandé de les utiliser
+    avec le script de contrôle <code class="program"><a href="./programs/apachectl.html">apachectl</a></code>, qui se
+    chargera de les passer à <code class="program"><a href="./programs/httpd.html">httpd</a></code>.</p>
+
+    <p>Après avoir envoyé un signal à <code class="program"><a href="./programs/httpd.html">httpd</a></code>, vous pouvez
+    suivre le cours de son action en entrant :</p>
+
+<div class="example"><p><code>tail -f /usr/local/apache2/logs/error_log</code></p></div>
+
+    <p>Adaptez ces exemples en fonction de la définition de vos directives
+    <code class="directive"><a href="./mod/core.html#serverroot">ServerRoot</a></code> et
+    <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>.</p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="term" id="term">Arrêter immédiatement</a></h2>
+
+<dl><dt>Signal: TERM</dt>
+<dd><code>apachectl -k stop</code></dd>
+</dl>
+
+    <p>L'envoi du signal <code>TERM</code> ou <code>stop</code> au
+    processus parent induit chez celui-ci une tentative immédiate
+    de tuer tous ses processus enfants. Cela peut durer plusieurs secondes.
+    Après cela, le processus parent lui-même se termine. Toutes les requêtes
+    en cours sont terminées, et plus aucune autre n'est traitée.</p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="graceful" id="graceful">Redémarrage en douceur</a></h2>
+
+<dl><dt>Signal: USR1</dt>
+<dd><code>apachectl -k graceful</code></dd>
+</dl>
+
+    <p>L'envoi du signal <code>USR1</code> ou <code>graceful</code> au
+    processus parent lui fait envoyer aux processus enfants
+    <em>l'ordre</em> de se terminer une fois leur requête courante
+    traitée (ou de se terminer immédiatement s'ils n'ont plus rien à traiter).
+    Le processus parent relit ses fichiers de configuration et
+    réouvre ses fichiers de log. Chaque fois qu'un enfant s'éteint, le
+    processus parent le remplace par un processus
+    enfant de la nouvelle <em>génération</em> de la
+    configuration, et celui-ci commence immédiatement à traiter les
+    nouvelles requêtes.</p>
+
+    <p>Ce code est conçu pour toujours respecter la directive de contrôle
+    de processus des modules MPMs, afin que les nombres de processus et de
+    threads
+    disponibles pour traiter les demandes des clients soient maintenus à
+    des valeurs appropriées tout au long du processus de démarrage.
+    En outre, il respecte la directive
+    <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> de la manière
+    suivante : si après une seconde au moins <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code> nouveaux processus
+    enfants n'ont pas été créés, un nombre suffisant de processus
+    supplémentaires est créé pour combler le manque. Ainsi le code
+    tente de maintenir à la fois le nombre approprié de processus enfants
+    en fonction de la charge du serveur, et vos souhaits définis par la
+    directive <code class="directive"><a href="./mod/mpm_common.html#startservers">StartServers</a></code>.</p>
+
+    <p>Les utilisateurs du module <code class="module"><a href="./mod/mod_status.html">mod_status</a></code>
+    noteront que les statistiques du serveur ne sont <strong>pas</strong>
+    remises à zéro quand un signal <code>USR1</code> est envoyé. Le code
+    a été conçu à la fois pour minimiser la durée durant laquelle le
+    serveur ne peut pas traiter de nouvelles requêtes (elle sont mises en
+    file d'attente par le système d'exploitation, et ne sont ainsi jamais
+    perdues) et pour respecter vos paramètres de personnalisation.
+    Afin d'accomplir ceci, il doit conserver le
+    <em>tableau</em> utilisé pour garder la trace de tous les processus
+    enfants au cours des différentes générations.</p>
+
+    <p>Le module status utilise aussi un <code>G</code> afin d'indiquer
+    quels processus enfants ont encore des traitements de requêtes en cours
+    débutés avant que l'ordre graceful restart ne soit donné.</p>
+
+    <p>Pour l'instant, il est impossible pour un script de rotation
+    des logs utilisant
+    <code>USR1</code> de savoir de manière certaine si tous les processus
+    enfants inscrivant des traces de pré-redémarrage sont terminés.
+    Nous vous suggérons d'attendre un délai suffisant après l'envoi du
+    signal <code>USR1</code>
+    avant de faire quoi que ce soit avec les anciens logs. Par exemple,
+    si la plupart de vos traitements durent moins de 10 minutes pour des
+    utilisateurs empruntant des liaisons à faible bande passante, alors vous
+    devriez attendre 15 minutes avant de faire quoi que ce soit
+    avec les anciens logs.</p>
+
+    <div class="note">
+    Si votre fichier de configuration comporte des erreurs lorsque vous
+    effectuez un redémarrage, votre processus parent ne redémarrera pas
+    et se terminera avec une erreur. Dans le cas d'un redémarrage en douceur
+    (graceful restart), il laissera les processus enfants
+    s'exécuter quand il s'arrêtera. (Ce sont les processus enfants qui
+    "s'arrêtent en douceur" en terminant de traiter leur dernière requête.)
+    Ceci provoquera des problèmes si vous tentez de redémarrer le serveur
+    -- il ne pourra pas s'associer à ses ports d'écoute. Avant d'effectuer un
+    redémarrage, vous pouvez vérifier la syntaxe des fichiers de
+    configuration à l'aide de l'argument de ligne de commande <code>-t</code>
+    (voir <code class="program"><a href="./programs/httpd.html">httpd</a></code>).
+
+    Ceci ne garantit pas encore que le serveur va redémarrer
+    correctement. Pour vérifier la sémantique des fichiers de configuration
+    en plus de leur syntaxe, vous pouvez essayer de démarrer
+    <code class="program"><a href="./programs/httpd.html">httpd</a></code> sous un utilisateur non root.
+    S'il n'y a pas d'erreurs, il tentera d'ouvrir ses sockets et ses fichiers
+    de log et échouera car il n'a pas les privilèges root (ou parce que
+    l'instance actuelle de
+    <code class="program"><a href="./programs/httpd.html">httpd</a></code> est déjà associée à ces ports). S'il échoue
+    pour toute autre raison, il y a probablement une erreur dans le
+    fichier de configuration et celle-ci doit être corrigée avant de lancer
+    le redémarrage en douceur.</div>
+</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="hup" id="hup">Redémarrer immédiatement</a></h2>
+
+<dl><dt>Signal: HUP</dt>
+<dd><code>apachectl -k restart</code></dd>
+</dl>
+
+    <p>L'envoi du signal <code>HUP</code> ou <code>restart</code> au
+    processus parent lui fait tuer ses processus enfants comme pour le signal
+    <code>TERM</code>, mais le processus parent ne se termine pas.
+    Il relit ses fichiers de configuration, et réouvre ses fichiers de log.
+    Puis il donne naissance à un nouveau jeu de processus enfants
+    et continue de traiter les requêtes.</p>
+
+    <p>Les utilisateurs du module <code class="module"><a href="./mod/mod_status.html">mod_status</a></code>
+    noteront que les statistiques du serveur sont remises à zéro quand un
+    signal <code>HUP</code> est envoyé.</p>
+
+<div class="note">Si votre fichier de configuration comporte des erreurs quand vous
+effectuez un redémarrage, votre processus parent ne redémarrera pas,
+il se terminera avec une erreur. Voir plus haut la méthode à employer
+pour éviter ce problème.</div>
+</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="gracefulstop" id="gracefulstop">Arrêt en douceur</a></h2>
+
+<dl><dt>Signal : WINCH</dt>
+<dd><code>apachectl -k graceful-stop</code></dd>
+</dl>
+
+    <p>L'envoi du signal <code>WINCH</code> ou <code>graceful-stop</code>
+    au processus parent lui fait <em>aviser</em> les processus enfants
+    de s'arrêter après le traitement de leur requête en cours
+    (ou de s'arrêter immédiatement s'ils n'ont plus de requête à traiter).
+    Le processus parent va alors supprimer son fichier
+    <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code> et cesser l'écoute
+    de tous ses ports. Le processus parent va continuer à s'exécuter,
+    et va surveiller les processus enfants
+    qui ont encore des requêtes à traiter. Lorsque tous les processus enfants
+    ont terminé leurs traitements et se sont arrêtés ou lorsque le délai
+    spécifié par la directive <code class="directive"><a href="./mod/mpm_common.html#gracefulshutdowntimeout">GracefulShutdownTimeout</a></code> a été atteint,
+    le processus parent s'arrêtera à son tour.  Si ce délai est atteint,
+    tout processus enfant encore en cours d'exécution se verra envoyer
+    le signal <code>TERM</code>
+    afin de le forcer à s'arrêter.</p>
+
+    <p>L'envoi du signal <code>TERM</code> va arrêter immédiatement
+    les processus parent et enfants en état "graceful". Cependant,
+    comme le fichier <code class="directive"><a href="./mod/mpm_common.html#pidfile">PidFile</a></code>
+    aura été supprimé, vous ne pourrez pas utiliser
+    <code>apachectl</code> ou <code>httpd</code> pour envoyer ce signal.</p>
+
+    <div class="note"><p>Le signal <code>graceful-stop</code> vous permet d'exécuter
+    simultanément plusieurs instances de <code class="program"><a href="./programs/httpd.html">httpd</a></code>
+    avec des configurations identiques. Ceci s'avère une fonctionnalité
+    puissante quand vous effectuez des mises à jour "en douceur" d'Apache;
+    cependant, cela peut aussi causer des blocages fatals et des
+    situations de compétition (race conditions)
+    avec certaines configurations.</p>
+
+    <p>On a pris soin de s'assurer que les fichiers sur disque
+    comme ceux définis par les directives
+    <code class="directive"><a href="./mod/core.html#lockfile">Lockfile</a></code> et
+    <code class="directive"><a href="./mod/mod_cgid.html#scriptsock">ScriptSock</a></code> contiennent le PID
+    du serveur dans leurs noms donc ils coexistent sans problème.
+    Cependant, si une directive de
+    configuration , un module tiers ou une CGI résidente utilise un autre
+    verrou ou fichier d'état sur disque, il faut prendre soin de s'assurer
+    que chaque instance de <code class="program"><a href="./programs/httpd.html">httpd</a></code> qui s'exécute
+    n'écrase pas les fichiers des autres instances.</p>
+
+    <p>Vous devez aussi prendre garde aux autres situations de compétition,
+    comme l'utilisation de l'enregistrement des logs avec un transfert de ceux-ci
+    dans le style <code class="program"><a href="./programs/rotation des logs.html">rotation des logs</a></code>. Plusieurs instances
+    du programme de <code class="program"><a href="./programs/rotation des logs.html">rotation des logs</a></code> qui tentent d'effectuer
+    une rotation des mêmes fichiers de log en même temps peuvent détruire
+    mutuellement leurs propres fichiers de log.</p></div>
+</div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="./de/stopping.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
+<a href="./en/stopping.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
+<a href="./fr/stopping.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
+</div><div id="footer">
+<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Authorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div>
+</body></html>
\ No newline at end of file

Added: httpd/httpd/branches/2.2.x/docs/manual/stopping.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/stopping.xml.fr?view=auto&rev=566566
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/stopping.xml.fr (added)
+++ httpd/httpd/branches/2.2.x/docs/manual/stopping.xml.fr Thu Aug 16 01:44:33 2007
@@ -0,0 +1,266 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
+<!-- LastChangedRevision English document : 420990 -->
+<!-- French translation : Lucien GENTIS -->
+<!-- $LastChangedRevision: 2007070101 $ -->
+
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements.  See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<manualpage metafile="stopping.xml.meta">
+
+  <title>Arr&ecirc;t et red&eacute;marrage</title>
+
+<summary>
+    <p>Ce document couvre l'arr&ecirc;t et le red&eacute;marrage d'Apache sur
+    les syst&egrave;mes Unix et similaires. Les utilisateurs de Windows NT, 2000
+    and XP doivent consulter
+    <a href="platform/windows.html#winsvc">Ex&eacute;cuter Apache en tant que
+    service</a> et les utilisateurs de Windows 9x et ME doivent consulter
+    <a href="platform/windows.html#wincons">Ex&eacute;cuter Apache comme une
+    application de type console</a> pour plus d'informations sur le contr&ocirc;le
+    d'Apache &agrave; partir de ces plateformes.</p>
+</summary>
+
+<seealso><program>httpd</program></seealso>
+<seealso><program>apachectl</program></seealso>
+<seealso><a href="invoking.html">D&eacute;marrage</a></seealso>
+
+<section id="introduction"><title>Introduction</title>
+
+    <p>Afin d'arr&ecirc;ter ou red&eacute;marrer Apache, vous devez envoyer un signal aux
+    processus <program>httpd</program> en cours d'ex&eacute;cution.  Les signaux
+    peuvent &ecirc;tre envoy&eacute;s de deux mani&egrave;res.  Tout d'abord, vous pouvez
+    utiliser la commande unix <code>kill</code>
+    pour envoyer directement des signaux aux processus. Vous pouvez remarquer
+    que plusieurs processus <program>httpd</program> s'ex&eacute;cutent sur votre
+    syst&egrave;me, mais il vous suffit d'envoyer les signaux au processus parent,
+    dont le PID est enregistr&eacute; dans le fichier pr&eacute;cis&eacute; par la directive
+    <directive module="mpm_common">PidFile</directive>. C'est &agrave; dire que vous
+    n'aurez jamais besoin d'envoyer des signaux &agrave; aucun de ces processus,
+    sauf au processus parent. Trois types de signaux peuvent &ecirc;tre envoy&eacute;s
+    au processus parent :
+    <code><a href="#term">TERM</a></code>,
+    <code><a href="#graceful">USR1</a></code>,
+    <code><a href="#hup">HUP</a></code>, et
+    <code><a href="#gracefulstop">WINCH</a></code>, qui
+    sera d&eacute;crit plus loin.</p>
+
+    <p>Pour envoyer un signal au processus parent, vous devez entrer une commande
+    du style :</p>
+
+<example>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</example>
+
+    <p>La seconde m&eacute;thode permettant d'envoyer des signaux aux processus
+    <program>httpd</program>
+    consiste &agrave; utiliser les options de ligne de commande <code>-k</code> :
+    <code>stop</code>,
+    <code>restart</code>, <code>graceful</code> et <code>graceful-stop</code>,
+    comme d&eacute;crit ci-dessous.  Ce sont des arguments du binaire
+    <program> httpd</program>, mais il est recommand&eacute; de les utiliser
+    avec le script de contr&ocirc;le <program>apachectl</program>, qui se
+    chargera de les passer &agrave; <program>httpd</program>.</p>
+
+    <p>Apr&egrave;s avoir envoy&eacute; un signal &agrave; <program>httpd</program>, vous pouvez
+    suivre le cours de son action en entrant :</p>
+
+<example>tail -f /usr/local/apache2/logs/error_log</example>
+
+    <p>Adaptez ces exemples en fonction de la d&eacute;finition de vos directives
+    <directive module="core">ServerRoot</directive> et
+    <directive module="mpm_common">PidFile</directive>.</p>
+</section>
+
+<section id="term"><title>Arr&ecirc;ter imm&eacute;diatement</title>
+
+<dl><dt>Signal: TERM</dt>
+<dd><code>apachectl -k stop</code></dd>
+</dl>
+
+    <p>L'envoi du signal <code>TERM</code> ou <code>stop</code> au
+    processus parent induit chez celui-ci une tentative imm&eacute;diate
+    de tuer tous ses processus enfants. Cela peut durer plusieurs secondes.
+    Apr&egrave;s cela, le processus parent lui-m&ecirc;me se termine. Toutes les requ&ecirc;tes
+    en cours sont termin&eacute;es, et plus aucune autre n'est trait&eacute;e.</p>
+</section>
+
+<section id="graceful"><title>Red&eacute;marrage en douceur</title>
+
+<dl><dt>Signal: USR1</dt>
+<dd><code>apachectl -k graceful</code></dd>
+</dl>
+
+    <p>L'envoi du signal <code>USR1</code> ou <code>graceful</code> au
+    processus parent lui fait envoyer aux processus enfants
+    <em>l'ordre</em> de se terminer une fois leur requ&ecirc;te courante
+    trait&eacute;e (ou de se terminer imm&eacute;diatement s'ils n'ont plus rien &agrave; traiter).
+    Le processus parent relit ses fichiers de configuration et
+    r&eacute;ouvre ses fichiers de log. Chaque fois qu'un enfant s'&eacute;teint, le
+    processus parent le remplace par un processus
+    enfant de la nouvelle <em>g&eacute;n&eacute;ration</em> de la
+    configuration, et celui-ci commence imm&eacute;diatement &agrave; traiter les
+    nouvelles requ&ecirc;tes.</p>
+
+    <p>Ce code est con&ccedil;u pour toujours respecter la directive de contr&ocirc;le
+    de processus des modules MPMs, afin que les nombres de processus et de
+    threads
+    disponibles pour traiter les demandes des clients soient maintenus &agrave;
+    des valeurs appropri&eacute;es tout au long du processus de d&eacute;marrage.
+    En outre, il respecte la directive
+    <directive module="mpm_common">StartServers</directive> de la mani&egrave;re
+    suivante : si apr&egrave;s une seconde au moins <directive
+    module="mpm_common">StartServers</directive> nouveaux processus
+    enfants n'ont pas &eacute;t&eacute; cr&eacute;&eacute;s, un nombre suffisant de processus
+    suppl&eacute;mentaires est cr&eacute;&eacute; pour combler le manque. Ainsi le code
+    tente de maintenir &agrave; la fois le nombre appropri&eacute; de processus enfants
+    en fonction de la charge du serveur, et vos souhaits d&eacute;finis par la
+    directive <directive module="mpm_common">StartServers</directive>.</p>
+
+    <p>Les utilisateurs du module <module>mod_status</module>
+    noteront que les statistiques du serveur ne sont <strong>pas</strong>
+    remises &agrave; z&eacute;ro quand un signal <code>USR1</code> est envoy&eacute;. Le code
+    a &eacute;t&eacute; con&ccedil;u &agrave; la fois pour minimiser la dur&eacute;e durant laquelle le
+    serveur ne peut pas traiter de nouvelles requ&ecirc;tes (elle sont mises en
+    file d'attente par le syst&egrave;me d'exploitation, et ne sont ainsi jamais
+    perdues) et pour respecter vos param&egrave;tres de personnalisation.
+    Afin d'accomplir ceci, il doit conserver le
+    <em>tableau</em> utilis&eacute; pour garder la trace de tous les processus
+    enfants au cours des diff&eacute;rentes g&eacute;n&eacute;rations.</p>
+
+    <p>Le module status utilise aussi un <code>G</code> afin d'indiquer
+    quels processus enfants ont encore des traitements de requ&ecirc;tes en cours
+    d&eacute;but&eacute;s avant que l'ordre graceful restart ne soit donn&eacute;.</p>
+
+    <p>Pour l'instant, il est impossible pour un script de rotation
+    des logs utilisant
+    <code>USR1</code> de savoir de mani&egrave;re certaine si tous les processus
+    enfants inscrivant des traces de pr&eacute;-red&eacute;marrage sont termin&eacute;s.
+    Nous vous sugg&eacute;rons d'attendre un d&eacute;lai suffisant apr&egrave;s l'envoi du
+    signal <code>USR1</code>
+    avant de faire quoi que ce soit avec les anciens logs. Par exemple,
+    si la plupart de vos traitements durent moins de 10 minutes pour des
+    utilisateurs empruntant des liaisons &agrave; faible bande passante, alors vous
+    devriez attendre 15 minutes avant de faire quoi que ce soit
+    avec les anciens logs.</p>
+
+    <note>
+    Si votre fichier de configuration comporte des erreurs lorsque vous
+    effectuez un red&eacute;marrage, votre processus parent ne red&eacute;marrera pas
+    et se terminera avec une erreur. Dans le cas d'un red&eacute;marrage en douceur
+    (graceful restart), il laissera les processus enfants
+    s'ex&eacute;cuter quand il s'arr&ecirc;tera. (Ce sont les processus enfants qui
+    "s'arr&ecirc;tent en douceur" en terminant de traiter leur derni&egrave;re requ&ecirc;te.)
+    Ceci provoquera des probl&egrave;mes si vous tentez de red&eacute;marrer le serveur
+    -- il ne pourra pas s'associer &agrave; ses ports d'&eacute;coute. Avant d'effectuer un
+    red&eacute;marrage, vous pouvez v&eacute;rifier la syntaxe des fichiers de
+    configuration &agrave; l'aide de l'argument de ligne de commande <code>-t</code>
+    (voir <program>httpd</program>).
+
+    Ceci ne garantit pas encore que le serveur va red&eacute;marrer
+    correctement. Pour v&eacute;rifier la s&eacute;mantique des fichiers de configuration
+    en plus de leur syntaxe, vous pouvez essayer de d&eacute;marrer
+    <program>httpd</program> sous un utilisateur non root.
+    S'il n'y a pas d'erreurs, il tentera d'ouvrir ses sockets et ses fichiers
+    de log et &eacute;chouera car il n'a pas les privil&egrave;ges root (ou parce que
+    l'instance actuelle de
+    <program>httpd</program> est d&eacute;j&agrave; associ&eacute;e &agrave; ces ports). S'il &eacute;choue
+    pour toute autre raison, il y a probablement une erreur dans le
+    fichier de configuration et celle-ci doit &ecirc;tre corrig&eacute;e avant de lancer
+    le red&eacute;marrage en douceur.</note>
+</section>
+
+<section id="hup"><title>Red&eacute;marrer imm&eacute;diatement</title>
+
+<dl><dt>Signal: HUP</dt>
+<dd><code>apachectl -k restart</code></dd>
+</dl>
+
+    <p>L'envoi du signal <code>HUP</code> ou <code>restart</code> au
+    processus parent lui fait tuer ses processus enfants comme pour le signal
+    <code>TERM</code>, mais le processus parent ne se termine pas.
+    Il relit ses fichiers de configuration, et r&eacute;ouvre ses fichiers de log.
+    Puis il donne naissance &agrave; un nouveau jeu de processus enfants
+    et continue de traiter les requ&ecirc;tes.</p>
+
+    <p>Les utilisateurs du module <module>mod_status</module>
+    noteront que les statistiques du serveur sont remises &agrave; z&eacute;ro quand un
+    signal <code>HUP</code> est envoy&eacute;.</p>
+
+<note>Si votre fichier de configuration comporte des erreurs quand vous
+effectuez un red&eacute;marrage, votre processus parent ne red&eacute;marrera pas,
+il se terminera avec une erreur. Voir plus haut la m&eacute;thode &agrave; employer
+pour &eacute;viter ce probl&egrave;me.</note>
+</section>
+
+<section id="gracefulstop"><title>Arr&ecirc;t en douceur</title>
+
+<dl><dt>Signal : WINCH</dt>
+<dd><code>apachectl -k graceful-stop</code></dd>
+</dl>
+
+    <p>L'envoi du signal <code>WINCH</code> ou <code>graceful-stop</code>
+    au processus parent lui fait <em>aviser</em> les processus enfants
+    de s'arr&ecirc;ter apr&egrave;s le traitement de leur requ&ecirc;te en cours
+    (ou de s'arr&ecirc;ter imm&eacute;diatement s'ils n'ont plus de requ&ecirc;te &agrave; traiter).
+    Le processus parent va alors supprimer son fichier
+    <directive  module="mpm_common">PidFile</directive> et cesser l'&eacute;coute
+    de tous ses ports. Le processus parent va continuer &agrave; s'ex&eacute;cuter,
+    et va surveiller les processus enfants
+    qui ont encore des requ&ecirc;tes &agrave; traiter. Lorsque tous les processus enfants
+    ont termin&eacute; leurs traitements et se sont arr&ecirc;t&eacute;s ou lorsque le d&eacute;lai
+    sp&eacute;cifi&eacute; par la directive <directive
+    module="mpm_common">GracefulShutdownTimeout</directive> a &eacute;t&eacute; atteint,
+    le processus parent s'arr&ecirc;tera &agrave; son tour.  Si ce d&eacute;lai est atteint,
+    tout processus enfant encore en cours d'ex&eacute;cution se verra envoyer
+    le signal <code>TERM</code>
+    afin de le forcer &agrave; s'arr&ecirc;ter.</p>
+
+    <p>L'envoi du signal <code>TERM</code> va arr&ecirc;ter imm&eacute;diatement
+    les processus parent et enfants en &eacute;tat "graceful". Cependant,
+    comme le fichier <directive module="mpm_common">PidFile</directive>
+    aura &eacute;t&eacute; supprim&eacute;, vous ne pourrez pas utiliser
+    <code>apachectl</code> ou <code>httpd</code> pour envoyer ce signal.</p>
+
+    <note><p>Le signal <code>graceful-stop</code> vous permet d'ex&eacute;cuter
+    simultan&eacute;ment plusieurs instances de <program>httpd</program>
+    avec des configurations identiques. Ceci s'av&egrave;re une fonctionnalit&eacute;
+    puissante quand vous effectuez des mises &agrave; jour "en douceur" d'Apache;
+    cependant, cela peut aussi causer des blocages fatals et des
+    situations de comp&eacute;tition (race conditions)
+    avec certaines configurations.</p>
+
+    <p>On a pris soin de s'assurer que les fichiers sur disque
+    comme ceux d&eacute;finis par les directives
+    <directive module="core">Lockfile</directive> et
+    <directive  module="mod_cgid">ScriptSock</directive> contiennent le PID
+    du serveur dans leurs noms donc ils coexistent sans probl&egrave;me.
+    Cependant, si une directive de
+    configuration , un module tiers ou une CGI r&eacute;sidente utilise un autre
+    verrou ou fichier d'&eacute;tat sur disque, il faut prendre soin de s'assurer
+    que chaque instance de <program>httpd</program> qui s'ex&eacute;cute
+    n'&eacute;crase pas les fichiers des autres instances.</p>
+
+    <p>Vous devez aussi prendre garde aux autres situations de comp&eacute;tition,
+    comme l'utilisation de l'enregistrement des logs avec un transfert de ceux-ci
+    dans le style <program>rotation des logs</program>. Plusieurs instances
+    du programme de <program>rotation des logs</program> qui tentent d'effectuer
+    une rotation des m&ecirc;mes fichiers de log en m&ecirc;me temps peuvent d&eacute;truire
+    mutuellement leurs propres fichiers de log.</p></note>
+</section>
+
+</manualpage>



Mime
View raw message