Mise à jour vers 2.2 depuis 2.0

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à Apache. Ces informations ne sont que de brèves notes, et vous devriez trouver plus d'informations dans le document Nouvelles fonctionnalités, ou dans le fichier src/CHANGES.

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

Vue d'ensemble des nouvelles fonctionnalités de Apache 2.2

Modifications de la configuration au moment de la compilation

Le processus de compilation est très similaire à celui de la version 2.0. Dans certains cas, vous pourrez même utiliser votre ancienne ligne de commande configure (que vous trouverez dans le fichier build/config.nice à la racine du répertoire des sources de votre serveur). Les changements qui devront être le plus souvent effectués concerneront des noms de modules, et en particulier les modules gérant l'authentification et les autorisations. Quelques exemples de modifications :

mod_imap a été renommé en mod_imagemap
mod_auth a été scindé en quatre modules : mod_auth_basic, mod_authn_file, mod_authz_user, et mod_authz_groupfile
mod_access a été renommé en mod_authz_host
mod_auth_ldap a été renommé en mod_authnz_ldap
La version requise pour l'API APR est la 1.0.
La version de la bibliothèque PCRE intégrée est la 5.0

Modifications de la configuration à l'exécution

Vos fichiers de configuration et scripts de démarrage de la version 2.0 existante peuvent en général être utilisés sans modification avec la version 2.2. Quelques petits ajustements peuvent cependant être nécessaires dans le cas de configurations particulières comme décrit plus bas. En outre, si des modules standards sont chargés dynamiquement à l'aide de la directive LoadModule, vous devez vérifier les changements de noms de modules mentionnés plus haut.

Si vous choisissez d'utiliser le nouveau fichier de configuration par défaut de la version 2.2, vous vous apercevrez qu'il a été considérablement simplifié et ne conserve que les points les plus essentiels de la configuration. Plusieurs exemples de configurations utilisant des fonctionnalités plus avancées sont disponibles dans le répertoire conf/extra/ de l'installation du serveur. Les fichiers de configuration par défaut se trouvent dans le répertoire conf/original.

Quelques changements dans la configuration à l'exécution que vous pouvez noter :

L'option startssl du programme apachectl n'est plus disponible. Pour activer le support SSL, vous devez éditer httpd.conf de façon à inclure les directives du module mod_ssl correspondantes, puis utiliser la commande apachectl start pour démarrer le serveur. Vous trouverez un exemple de configuration permettant d'activer le module mod_ssl dans le fichier conf/extra/httpd-ssl.conf.
La directive UseCanonicalName est maintenant définie par défaut à Off. Si cette directive n'était pas présente dans votre ancien fichier de configuration, vous pouvez ajouter UseCanonicalName On dans le nouveau pour garder inchangé l'ancien comportement.
Le module mod_userdir ne sera appliqué sur les requêtes que si une directive UserDir spécifiant un nom de répertoire se trouve dans le fichier de configuration. Pour garder l'ancien comportement par défaut inchangé, placer la directive UserDir public_html dans votre fichier de configuration.
La directive AuthDigestFile du module mod_auth_digest a été fusionnée avec la directive AuthUserFile et appartient maintenant au module mod_authn_file.

Changements divers

Le module mod_cache, qui était expérimental dans Apache 2.0, est désormais un module standard.
Le module mod_disk_cache, qui était expérimental dans Apache 2.0, est désormais un module standard.
Le module mod_mem_cache, qui était expérimental dans Apache 2.0, est désormais un module standard.
Le module mod_charset_lite, qui était expérimental dans Apache 2.0, est désormais un module standard.
Le module mod_dumpio, qui était expérimental dans Apache 2.0, est désormais un module standard.

Modules tiers

De nombreux modules tiers conçus pour la version 2.0 fonctionneront sans changement avec le serveur HTTP Apache version 2.2. Mais tous ces modules doivent être recompilés avant de pouvoir être chargés.