From: Lucien Gentis Date: Sun, 17 Oct 2010 12:28:11 +0000 (+0000) Subject: Update. X-Git-Tag: 2.3.9~294 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=df7a8ff327170aeb4966d55614273eba5abb0bfb;p=thirdparty%2Fapache%2Fhttpd.git Update. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1023475 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/upgrading.xml.fr b/docs/manual/upgrading.xml.fr new file mode 100644 index 00000000000..b7492a9c608 --- /dev/null +++ b/docs/manual/upgrading.xml.fr @@ -0,0 +1,306 @@ + + + + + + + + + + + +Mise à jour vers 2.4 depuis 2.2 + + +

Afin d'assister les utilisateurs lors de leurs opérations de mise à + jour, nous maintenons un document + qui comporte des informations critiques à l'attention des personnes qui + utilisent déjà le serveur HTTP Apache. Ces informations + ne sont que de brèves notes, et vous + trouverez plus d'informations dans le document Nouvelles fonctionnalités, ou dans + le fichier src/CHANGES. Les développeurs d'applications + et de modules trouveront un résumé des modifications de l'API dans la + vue d'ensemble Mises à jour de + l'API.

+ +

Ce document présente les changements de comportement du serveur qui + peuvent nécessiter une modification de la configuration, et la manière + d'utiliser la version 2.4 du serveur en continuant d'utiliser la + version 2.2. Pour tirer parti des nouvelles fonctionnalités de la + version 2.4, reportez-vous au document "Nouvelles fonctionnalités".

+ +

Ce document ne décrit que les modifications intervenues entre les versions + 2.2 et 2.4. Si vous effectuez une mise à jour depuis la version 2.0, vous + devez aussi consulter le + document de mise + à jour de 2.0 vers 2.2.

+ + +Vue d'ensemble des nouvelles +fonctionnalités du serveur HTTP Apache 2.4 + +
+ Modifications de la configuration au moment de la compilation +

Le processus de compilation est très similaire à celui de la + version 2.2. Dans la plupart des cas, vous pourrez utiliser votre + ancienne ligne de commande configure (telle qu'elle + est enregistrée dans le fichier build/config.nice + situé dans le répertoire de compilation du serveur). Voici certains + changements intervenus dans la configuration par défaut :

+ +
    +
  • Les modules suivants ont été supprimés : mod_authn_default, + mod_authz_default et mod_mem_cache. Si vous utilisiez + mod_mem_cache sous la version 2.2, reportez-vous à + mod_disk_cache dans la version 2.4.
    • + +
  • Toutes les implémentations de répartition de charge ont été + déplacées vers des sous-modules spécifiques de mod_proxy, comme + mod_lbmethod_bybusyness. Vous devrez compiler et + chargés tous les modules correspondants que votre configuration + utilise.
    • + +
  • Le support de BeOS, TPF, et des anciennes plates-formes telles + que A/UX, Next, et Tandem a été supprimé, car il a été supposé + qu'elles n'étaient plus maintenues.
    • + +
  • configure: les modules dynamiques (DSO) sont compilés par + défaut
    • + +
  • configure: le jeu de modules "most" est compilé par défaut
    • +
+ +
+ +
+ Modifications de la configuration à l'exécution +

Des changements significatifs dans la configuration de +l'autorisation, ainsi que quelques changements mineurs, peuvent +nécessiter une modification des fichiers de configuration de la version +2.2 avant de les utiliser sous la version 2.4.

+ +
+ Autorisation + +

Tout fichier de configuration qui gère des autorisations devra + probablement être modifié.

+ +

Vous devez vous reporter au document Authentification, autorisation et contrôle + d'accès, et plus particulièrement à la section Plus loin qu'une simple + autorisation qui explique les nouveaux mécanismes permettant de + contrôler l'ordre dans lequel les directives d'autorisation sont + appliquées.

+ +
+ Contrôle d'accès + +

Dans la version 2.2, le contrôle d'accès basé sur le nom d'hôte + du client, son adresse IP, ou d'autres caractéristiques de la + requête du client était assuré via les directives Order, Allow, Deny, et Satisfy.

+ +

Dans la version 2.4, ce contrôle d'accès est assuré, comme tout + contrôle d'autorisation, via le nouveau module + mod_authz_host. Bien que le module + mod_access_compat soit fourni à des fins de + compatibilité avec les anciennes configurations, les anciennes + directives de contrôle d'accès devront être remplacées par les + nouveaux mécanismes d'authentification.

+ +

Voici quelques exemples de contrôle d'accès avec l'ancienne et + la nouvelle méthode :

+ +

Dans cet exemple, toutes les requêtes sont rejetées :

+ + version 2.2 : + Order deny,allow
+ Deny from all + + + version 2.4 : + Require all denied + + +

Dans cet exemple, toutes les requêtes sont acceptées :

+ + version 2.2 : + Order allow,deny
+ Allow from all + + + version 2.4 : + Require all granted + + +

Dans l'exemple suivant, tous les hôtes du domaine apache.org + ont l'autorisation d'accès, tous les autres sont rejetés :

+ + + version 2.2 : + Order Deny,Allow
+ Deny from all
+ Allow from apache.org + + + version 2.4 : + Require host apache.org + +
+ +
+ +
+ Autres changements de configuration + +

D'autres ajustements mineurs peuvent s'avérer nécessaires pour + certaines configurations particulières, comme décrit ci-dessous.

+ +
    +
  • La directive MaxRequestsPerChild a + été renommée en MaxConnectionsPerChild, ce qui + correspond d'avantage à ce qu'elle fait.
    • + +
  • La directive DefaultType ne produit plus aucun + effet, si ce n'est d'émettre un avertissement si elle est + définie à une valeur autre que none. D'autres + directives de configuration la remplacent dans la version 2.4. +
    • + +
  • La valeur par défaut de la directive EnableSendfile est maintenant Off.
    • + +
  • mod_log_config: ${cookie}C + correspond au nom du cookie dans son ensemble, alors qu'avant, + toute sous-chaîne pouvait correspondre.
    • + +
  • mod_dav_fs: le format du fichier DavLockDB a changé pour les systèmes + avec inodes. L'ancien fichier DavLockDB doit être supprimé dans le + cadre de la mise à jour. +
    • + +
  • La directive KeepAlive + n'accepte que les valeurs On ou Off. + Avant, toute valeur autre que "Off" ou "0" était traitée comme + "On".
    • + +
  • Les directives AcceptMutex, LockFile, RewriteLock, SSLMutex, + SSLStaplingMutex et WatchdogMutexPath ont été remplacées par la + directive unique Mutex. + Vous devez évaluer l'impact de ces directives obsolètes dans + votre configuration version 2.2 afin de déterminer si elles + peuvent être simplement supprimées, ou si elles doivent être + remplacées par la directive Mutex.
    • + +
  • mod_cache: la directive CacheIgnoreURLSessionIdentifiers + effectue maintenent une correspondance exacte dans la chaîne de + paramètres au lieu d'une correspondance partielle. Si votre + configuration mettait en jeu des sous-chaînes comme + sessionid pour correspondre à + /une-application/image.gif;jsessionid=123456789, + vous devez maintenant utiliser la chaîne de correspondance + complète jsessionid. +
    • + +
  • mod_ldap: la directive LDAPTrustedClientCert s'utilise + maintenant exclusivement au sein d'une configuration de niveau + répertoire. Si vous utilisez cette directive, passez en revue + votre configuration pour vous assurer qu'elle est bien présente + dans tous les contextes de répertoire nécessaires.
    • + +
+
+
+ +
+ Changements divers + +
    +
  • mod_auto_index: extrait maintenant les titres + et affiche la description pour les fichiers .xhtml qui étaient + jusqu'alors ignorés.
    • +
  • htpasswd utilise maintenant par défaut les + condensés MD5 sur toutes les plates-formes.
    • +
+ +
+ +
+ Modules tiers + +

Tous les modules tiers doivent être recompilés pour la + version 2.4 avant d'être chargés.

+ +

De nombreux modules tiers conçus pour la version 2.2 + fonctionneront sans changement avec le serveur HTTP Apache + version 2.4. Certains nécessiterons cependant des modifications ; se + reporter à la vue d'ensemble Mise à jour de l'API.

+
+
+ Problèmes de mise à jour courants +
  • Erreurs au démarrage : +
      +
    • Invalid command 'User', perhaps misspelled or defined by + a module not included in the server configuration - chargez + le module mod_unixd
      • +
    • Invalid command 'Require', perhaps misspelled or defined + by a module not included in the server configuration, ou + Invalid command 'Order', perhaps misspelled or defined by a + module not included in the server configuration - chargez + le module mod_access_compat, ou mettez à jour + vers la version 2.4 les directives d'autorisation.
      • +
    • Ignoring deprecated use of DefaultType in line NN of + /path/to/httpd.conf - supprimez la directive DefaultType et remplacez-la par les + directives de configuration appropriées.
      • +
    • mixing * ports and non-* ports with a NameVirtualHost + address is not supported, Either NameVirtualHost + w.x.y.z:n has no VirtualHosts, or there is more than one identical + NameVirtualHost line, or your VirtualHost declarations do not + match the NameVirtualHost line - + ce ne sont pas des nouveaux messages, mais ils empêchent + maintenant le serveur de démarrer
      • +
    • _default_ is not allowed in NameVirtualHost + directive - l'explication est dans le message ; cette + définition n'a jamais été valide, mais elle empêche maintenant le + serveur de démarrer.
      • +
    • +
  • Erreurs de traitement des requêtes : +
      +
    • configuration error: couldn't check user: /path - + chargez le module mod_authn_core.
      • +
    +
    • +
+ +
+