You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by jf...@apache.org on 2007/08/16 10:44:34 UTC
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
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çu des nouvelles fonctionnalités dans Apache 2.2</title>
+
+<summary>
+ <p>Ce document décrit quelques uns des changements principaux entre
+ les versions 2.0 et 2.2 du serveur HTTP Apache. Pour les
+ nouvelles fonctionnalités ajoutées depuis la version 1.3, se
+ référer au document
+ <a href="new_features_2_0.html">2.0 new features</a>.</p>
+</summary>
+
+ <section id="core">
+ <title>Améliorations du système de base</title>
+ <dl>
+
+ <dt>Authn/Authz</dt>
+ <dd>Les modules d'authentification et d'autorisation intégrés
+ ont été refondus. Le nouveau module
+ <module>mod_authn_alias</module> permet de
+ simplifier considérablement certaines configurations d'authentification.
+ Voir <a href="#module">modification des noms de modules</a>,
+ et
+ <a href="#developer">les changements pour le développeur</a>
+ pour plus d'informations sur les conséquences de ces
+ changements pour les utilisateurs et les dé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ère qu'ils ont maintenant atteint
+ un degré de qualité suffisant pour leur mise en production. Le programme
+ <program>htcacheclean</program> a été ajouté 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éfaut a été simplifié
+ et modularisé. Les portions de configuration qui peuvent être
+ utilisées pour activer des fonctionnalités courantes sont
+ maintenant intégrées à Apache, et peuvent être facilement
+ ajoutées à la configuration principale du serveur.</dd>
+
+ <dt>Arrêt en douceur</dt>
+ <dd>Les modules MPM <module>prefork</module>,
+ <module>worker</module> et <module>event</module> permettent
+ maintenant l'arrê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 été ajoutée dans le but
+ de spécifier un délai optionnel, après lequel
+ <program>httpd</program> s'arrêtera quel que soit le statut
+ des requê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é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 à jour de la bibliothè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 être configuré 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îne de filtrage en sortie. Il permet
+ d'insérer des filtres conditionnels basés sur toute
+ requête, en-tête de réponse ou variable
+ d'environnement, et fait table rase des problèmes de dépendances
+ et d'ordonnancement rencontrés avec l'architecture 2.0.</dd>
+
+ <dt>Support des gros fichiers</dt>
+
+ <dd>httpd supporte maintenant les fichiers d'une taille supérieure
+ à 2GB sur les systèmes 32 bits UNIX modernes. Le support des
+ corps de requête d'une taille supérieure à 2GB a aussi été
+ ajouté.</dd>
+
+ <dt>Module MPM Event</dt>
+ <dd>Le module MPM <module>event</module> utilise un thread séparé
+ pour gérer les requêtes "Keep alive" et accepter des connexions.
+ Les requêtes "Keep alive" requéraient traditionnellement un
+ processus httpd dédié pour leur gestion. Ce processus dédié
+ ne pouvait plus être réutilisé jusqu'à ce que le délai "Keep Alive"
+ soit écoulé.</dd>
+
+ <dt>Support des bases de données SQL</dt>
+ <dd>Le module <p><module>mod_dbd</module>, associé à 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és.</p>
+ <p><strong>Utilisateurs Windows</strong> : veuillez noter que ce
+ support n'est pas encore inclus dans l'implé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éliorations des modules</title>
+ <dl>
+ <dt>Authn/Authz</dt>
+ <dd>Les modules du répertoire aaa ont été renommés et fournissent
+ un support amélioré pour la méthode d'authentification <strong>digest</strong>. Par exemple, mod_auth
+ est maintenant scindé 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 été renommé en
+ <module>mod_authz_host</module>. Est é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és comprennent l'utilisation des valeurs
+ d'attributs LDAP et des filtres de recherche avancé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ès aux ressources web selon leur appartenance
+ à un utilisateur au niveau du système de fichiers.</dd>
+
+ <dt><module>mod_version</module></dt>
+ <dd>Ce nouveau module permet de définir des blocs de configuration activables selon le numéro de version du serveur en fonctionnement.</dd>
+
+ <dt><module>mod_info</module></dt>
+ <dd>Un nouvel argument <code>?config</code> a été ajouté, qui permettra d'afficher
+ les directives de configuration telles qu'elles sont interprétées
+ par Apache, y compris le nom de fichier et le numéro de ligne.
+ Le module montre aussi l'ordre des point d'entrée de traitement d'une
+ requête (request hooks) ainsi que des informations de construction
+ supplémentaires, d'une manière similaire à <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 été ajouté, ce qui permet de passer d'une
+ connexion en clair au cryptage TLS.</dd>
+
+ <dt><module>mod_imagemap</module></dt>
+ <dd>mod_imap a été renommé en <module>mod_imagemap</module> afin
+ d'éviter une confusion pour les utilisateurs.</dd>
+ </dl>
+
+ </section>
+
+ <section id="programs">
+ <title>Améliorations des programmes</title>
+ <dl>
+ <dt><program>httpd</program></dt>
+ <dd>Une nouvelle option de ligne de commande <code>-M</code>
+ a été ajoutée, qui fournit la liste de tous les modules chargés
+ en fonction de la configuration réelle. À la différence de l'option
+ <code>-l</code>, cette liste inclut les Objets Dynamiques Partagés
+ (DSOs) chargés par l'intermédiaire du module
+ <module>mod_so</module>.</dd>
+ <dt><program>httxt2dbm</program></dt>
+ <dd>Un nouveau programme servant à générer des fichiers dbm à partir
+ d'une source texte, à 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é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ètes ont été supprimés du code de <code>APR</code> et
+ <code>APR-Util</code>. Pour plus de dé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égrés ont
+ été renommés de la manière suivante:
+ <ul>
+ <li>mod_auth_* -> Modules qui implémentent un mécanisme
+ d'authentification HTTP</li>
+ <li>mod_authn_* -> Modules qui fournissent un dispositif
+ d'authentification en arrière-plan</li>
+ <li>mod_authz_* -> Modules qui implémentent l'autorisation (ou l'accès)</li>
+ <li>mod_authnz_*-> Module qui implémentent à la fois
+ l'authentification & l'autorisation</li>
+ </ul>
+ L'organisation des méthodes d'authentification a également été revue, ce qui va simplifier
+ grandement l'ajout de nouvelles méthodes d'authentification.</dd>
+
+ <dt>Journalisation des erreurs de connexion</dt>
+
+ <dd>Une nouvelle fonction a été ajoutée, <code>ap_log_cerror</code>,
+ afin de pouvoir enregistrer les erreurs qui surviennent au cours de
+ la connexion du client. Une fois enregistré, le message inclut l'adresse IP du client.</dd>
+
+ <dt>Ajout d'une portion de code pour la vérification de la configuration</dt>
+
+ <dd>Un nouvel élément de traitement a été ajouté, <code>test_config</code>,
+ afin d'aider les modules qui ne veulent exécuter un code spécial
+ que si l'utilisateur passe le paramètre <code>-t</code> à
+ <program>httpd</program>.</dd>
+
+ <dt>Définition de la taille de la pile pour les modules MPM threadés</dt>
+
+ <dd>Une nouvelle directive a été ajoutée, <code>ThreadStackSize</code>
+ afin de définir la taille de la pile pour tous les modules MPM threadés.
+ Ceci s'avère nécessaire pour certains modules tiers sur des plateformes
+ dont la taille de la pile des threads par défaut est
+ trop petite.</dd>
+
+ <dt>Gestion de protocole pour les filtres en sortie</dt>
+
+ <dd>Par le passé, chaque filtre devait s'assurer que les en-têtes de
+ réponse corrects étaient générés dans la mesure où il les affectait.
+ Les filtres peuvent maintenant déléguer la gestion courante du
+ protocole au module
+ <module>mod_filter</module>, à l'aide des appels
+ <code>ap_register_output_filter_protocol</code> ou
+ <code>ap_filter_protocol</code>.</dd>
+
+ <dt>Ajout d'un élément de traitement pour le processus père (monitor hook)</dt>
+ <dd>Ce nouvel élément de traitement permet aux modules de lancer
+ des jobs réguliers/planifiés au niveau du processus père
+ (root).</dd>
+
+ <dt>Modifications de l'API de traitement des expressions régulières</dt>
+
+ <dd>Le fichier d'en-tête <code>pcreposix.h</code> n'est plus disponible;
+ il a été remplacé par le nouveau fichier
+ d'en-tête <code>ap_regex.h</code>. L'implémentation
+ POSIX.2 <code>regex.h</code> exposée dans l'ancien fichier d'en-tête
+ est maintenant disponible dans l'espace de nommage <code>ap_</code>
+ depuis <code>ap_regex.h</code>. Les appels à <code>regcomp</code>,
+ <code>regexec</code>, etc... peuvent être remplacés par des appels à
+ <code>ap_regcomp</code>, <code>ap_regcomp</code>.</dd>
+
+ <dt>Cadre d'application DBD (API pour base de données SQL)</dt>
+
+ <dd><p>Avec Apache 1.x et 2.0, les modules nécessitant un processus
+ SQL d'arrière-plan devaient s'en charger eux-mêmes. En dehors du fait
+ de réinventer la roue, ceci peut s'avérer très inefficace, par
+ exemple lorsque plusieurs modules maintiennent chacun leurs
+ propres connexions.</p>
+ <p>Apache 2.1 et supérieur fournissent l'API <code>ap_dbd</code> qui
+ permet la gestion des connexions à la base de données (y compris
+ les stratégies optimisées pour les modules MPM threadés
+ et non threadés), tandis que APR 1.2 et supérieur fournissent
+ l'API <code>apr_dbd</code> qui permet l'interaction avec la
+ base de données.</p>
+ <p>Les nouveaux modules DEVRAIENT désormais utiliser ces APIs pour
+ toutes les opérations liées aux bases de données SQL.
+ De même, les applications existantes DEVRAIENT être mises à jour
+ lorsque c'est possible, soit de manière transparente ou sous forme
+ d'une option recommandée à 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="<-" alt="<-" src="./images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <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"> de </a> |
+<a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
+<a href="./fr/stopping.html" title="Français"> fr </a> |
+<a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
+<a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </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"> de </a> |
+<a href="./en/stopping.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="./es/stopping.html" hreflang="es" rel="alternate" title="Español"> es </a> |
+<a href="./fr/stopping.html" title="Français"> fr </a> |
+<a href="./ja/stopping.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
+<a href="./ko/stopping.html" hreflang="ko" rel="alternate" title="Korean"> ko </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êt et redémarrage</title>
+
+<summary>
+ <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>
+</summary>
+
+<seealso><program>httpd</program></seealso>
+<seealso><program>apachectl</program></seealso>
+<seealso><a href="invoking.html">Démarrage</a></seealso>
+
+<section id="introduction"><title>Introduction</title>
+
+ <p>Afin d'arrêter ou redémarrer Apache, vous devez envoyer un signal aux
+ processus <program>httpd</program> 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 <program>httpd</program> 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
+ <directive module="mpm_common">PidFile</directive>. 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>
+
+<example>kill -TERM `cat /usr/local/apache2/logs/httpd.pid`</example>
+
+ <p>La seconde méthode permettant d'envoyer des signaux aux processus
+ <program>httpd</program>
+ 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
+ <program> httpd</program>, mais il est recommandé de les utiliser
+ avec le script de contrôle <program>apachectl</program>, qui se
+ chargera de les passer à <program>httpd</program>.</p>
+
+ <p>Après avoir envoyé un signal à <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éfinition de vos directives
+ <directive module="core">ServerRoot</directive> et
+ <directive module="mpm_common">PidFile</directive>.</p>
+</section>
+
+<section id="term"><title>Arrêter immé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é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>
+</section>
+
+<section id="graceful"><title>Redé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ê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
+ <directive module="mpm_common">StartServers</directive> de la manière
+ suivante : si après une seconde au moins <directive
+ module="mpm_common">StartServers</directive> 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 <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 à 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>
+
+ <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 <program>httpd</program>).
+
+ 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
+ <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 échouera car il n'a pas les privilèges root (ou parce que
+ l'instance actuelle de
+ <program>httpd</program> 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.</note>
+</section>
+
+<section id="hup"><title>Redémarrer immé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é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 <module>mod_status</module>
+ noteront que les statistiques du serveur sont remises à zéro quand un
+ signal <code>HUP</code> est envoyé.</p>
+
+<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.</note>
+</section>
+
+<section id="gracefulstop"><title>Arrê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ê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
+ <directive module="mpm_common">PidFile</directive> 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 <directive
+ module="mpm_common">GracefulShutdownTimeout</directive> 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 <directive module="mpm_common">PidFile</directive>
+ aura été supprimé, 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écuter
+ simultanément plusieurs instances de <program>httpd</program>
+ 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
+ <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è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 <program>httpd</program> 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 <program>rotation des logs</program>. Plusieurs instances
+ du programme de <program>rotation des logs</program> 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></note>
+</section>
+
+</manualpage>