Guide de mise à jour d'Apache

1.  Mise à jour depuis la version <2.2.6-r4

Les ebuilds Apache ont pendant très longtemps utilisé /etc/apache2/apache2-builtin-mods pour sélectionner les modules intégrés lors la compilation. Cependant, ce comportement a plusieurs désavantages :

• Il est impossible de sélectionner les modules intégrés lors de l'emerge initial.
• Portage ne sait pas quels modules ont été installés. Ceci est particulièrement gênant pour les paquets binaires.
• Portage essaiera d'écraser apache2-builtin-mods à chaque mise à jour.

Afin de rectifier cette situation, /etc/apache2/apache2-builtin-mods est devenu désuet et a été remplacé par la nouvelle variable USE_EXPAND APACHE2_MODULES. Pour convertir votre sélection de modules au nouveau format, utilisez la commande suivante :

$ echo APACHE2_MODULES=\"$(sed '/^mod_/s/mod_\(.*\)\s\+\(shared\|static\)/\1/;t n;d;:n' /etc/apache2/apache2-builtin-mods)\" >> /etc/make.conf
# rm /etc/apache2/apache2-builtin-mods

(Vous pouvez maintenant mettre à jour Apache en toute sécurité :)
# emerge -uva '>=www-servers/apache-2.2.6-r4'

En plus de la nouvelle variable APACHE2_MODULES, les options USE locales ont été nettoyées :

• Toutes les options USE MPM ont été déplacées dans la variable USE_EXPAND APACHE2_MPMS
• no-suexec est maintenant suexec
• static-modules est maintenant static

Pour une description détaillée des anciennes et nouvelles options USE correspondantes, lisez plus bas.

2.  Mise à jour depuis la version <2.0.52-r3

Introduction

La situation d'Apache et de ses modules dans Gentoo devenait vraiment insupportable. De nombreux problèmes ont rendu le support et la maintenance très difficiles pour l'équipe responsable d'Apache :

• La configuration par défaut venant avec Gentoo était vraiment trop différente de la configuration par défaut usuelle à laquelle la plupart des utilisateurs s'attendent.
• De nombreux modules utilisaient du code similaire, mais tous faisaient les choses à leur manière.
• La plupart des modules n'étaient pas maintenus correctement - principalement à cause du grand nombre de modules disponibles.
• Les modules n'avaient pas de standard de configuration.
• Certains modules fonctionnaient avec les deux versions d'Apache, mais les ebuilds ne savaient pas le gérer.
• Des options disponibles d'Apache ne l'étaient pas pour les utilisateurs de Gentoo (par exemple les MPM).
• Les bogues pour Apache s'accumulaient.

Ce document détaille comment effectuer la mise à jour sans casser votre système. Si vous êtes développeur ou voulez savoir ce que nous avons changé ou comment les ebuilds doivent être modifiés pour tirer parti de notre eclass, alors jetez un œil à la Documentation Apache pour les développeurs.

Instructions pour la mise à jour

Il y a eu de nombreux changements dans la manière de fonctionner d'Apache au sein de Gentoo. Chaque paquet qui est directement relié à Apache doit être mis à jour et certaines choses qui fonctionnaient avant ne fonctionneront plus.

D'abord, vous devez déterminer quels paquets vous devez mettre à jour. Vous pouvez faire cela en utilisant l'outil equery, appartenant au paquet app-portage/gentoolkit.

$ equery depends www-servers/apache
[ Searching for packages depending on www-servers/apache... ]
dev-db/phpmyadmin-2.5.6
dev-php/mod_php-4.3.10
dev-php/phpsysinfo-2.1-r2
net-www/mod_bandwidth-2.0.5
net-www/mod_layout-4.0.1a
net-www/mod_mp3-0.40
net-www/mod_random-2.0
net-www/mod_throttle-3.1.2-r1
www-apache/mod_ldap_userdir-1.1.4
www-apache/mod_loopback-1.04
www-apache/mod_watch-3.18
www-apps/viewcvs-0.9.2_p20030430

De nombreuses applications web ne sont pas concernées du fait qu'elles utilisent l'eclass webapp qui s'occupe de les installer correctement. Il est conseillé de vérifier l'existence d'une nouvelle révision.

Comme nous avons ajouté de nouvelles options à la variable USE, il peut être intéressant d'y jeter un œil et d'ajouter ce qui est nécessaire au fichier /etc/portage/package.use. Consultez les options USE d'Apache pour plus d'informations.

(Contrôler les options USE et les mises à jour nécessaires)
# emerge --pretend --verbose --update --newuse --deep apache subversion \
mod_php mod_bandwidth mod_layout mod_ldap_userdir mod_loopback mod_mp3 \
mod_random mod_throttle mod_watch

(Mettre les paquets à jour)
# emerge --verbose --update --newuse --deep apache subversion mod_php \
mod_bandwidth mod_layout mod_ldap_userdir mod_loopback mod_mp3 mod_random \
mod_throttle mod_watch

(Il peut être plus simple de mettre world à jour
plutôt que de faire comme ci-dessus)
# emerge --ask --verbose --update --newuse --deep world

Maintenant, il faut reconfigurer Apache et ses modules. Commencez par utiliser etc-update ou dispatch-conf pour mettre à jour les fichiers de /etc/init.d et /etc/conf.d. Vous remarquerez que les fichiers de configuration d'Apache ne s'affichent pas lors de la mise à jour, car ils ont été déplacés.

Si vous avez apporté des modifications aux anciens apache.conf et commonapache.conf par défaut, il vous faudra les transposer au fichier /etc/apache{|2}/httpd.conf. Les fichiers de configuration des modules et des hôtes virtuels ont aussi été déplacés : ils se trouvent maintenant respectivement dans /etc/apache2/modules.d et /etc/apache2/vhosts.d .

Une fois le transfert de vos modifications vers les nouveaux fichiers de configuration effectué, il vous faudra effacer les anciens fichiers (ou bien les déplacer dans un endroit sûr). Le nouveau script /etc/init.d/apache{|2} vérifie l'existence de ces fichiers et ne vous laisse pas lancer Apache tant qu'ils n'ont pas été enlevés pour signifier que vous avez reconfiguré Apache à l'aide des nouveaux fichiers.

Vous pouvez maintenant relancer Apache.

# /etc/init.d/apache stop
# /etc/init.d/apache start

Si vous rencontrez des problèmes, jetez un œil au Apache Troubleshooting Guide et si ça ne résoud pas votre problème, veuillez le rapporter sur le Bugzilla Gentoo. Veuillez préciser les modules activés et, si vous utilisez Apache 2, les options USE MPM que vous avez utilisées lors de la compilation. Vous pouvez aussi vous connecter à #gentoo-apache sur irc.freenode.net pour plus d'assistance.

3.  Options de la variable USE affectant Apache <2.2.6-r4

Des options de la variable USE sont particulières à Apache et ses modules. Apache supporte aussi plusieurs options plus génériques telles que ssl, mais leur effet sur Apache n'est guère différent de celui qu'elles ont sur les autres paquets, elles ne sont donc pas énumérées ici. Lancez emerge --verbose --pretend apache pour voir une liste complète des options supportées.

4.  Options USE affectant Apache 2.2.6-r4 et supérieur

Avec l'arrivée de la variable APACHE2_MODULES, un nettoyage général des options USE fut nécessaire. Le tableau suivant liste les options USE actuellement supportées pour apache-2.2.6-r4 et supérieurs, ainsi que leurs équivalents dans les versions précédentes.

Le tableau suivant liste les options de la variable APACHE2_MPMS actuellement supportées pour apache-2.2.6-r4 et leur précédente option USE locale correspondante.

Le tableau suivant liste les options de la variable APACHE2_MODULES actuellement supportés pour apache-2.2.6-r4.

Ce document est protégé par la licence Creative Commons : Paternité - Partage des Conditions Initiales à l'Identique 2.5.