Apache upgraden

1.  Upgraden von <2.2.6-r4

Die Apache-Ebuilds haben für eine lange Zeit /etc/apache2/apache2-builtin-mods benutzt, um die built-in Module zur Kompilierzeit auszuwählen. Dieses Verhalten hat jedoch einige Nachteile:

• Das Auwählen der built-in Module während des ersten Merges ist nicht möglich
• Portage weiß nicht, welche Module installiert wurden. Dies ist besonders nervig für binäre Pakete.
• Portage wird versuchen, apache2-builtin-mods bei jedem Upgrade zu überschreiben.

Um diese Lage zu bessern, wird /etc/apache2/apache2-builtin-mods nicht mehr länger benutzt und wurde zu den neuen Variablen APACHE2_MODULES und USE_EXPAND migriert. Um Ihre persönliche Modulauswahl ins neue Format zu konvertieren, benutzen Sie folgenden Befehl:

$ 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

(Sie können nun Apache sicher upgraden:)
# emerge -uva '>=www-servers/apache-2.2.6-r4'

Zusätzlich zu dem neuen APACHE2_MODULES wurden die lokalen USE-Flags aufgeräumt:

• Alle MPM USE-Flags wurden in die APACHE2_MPMS USE_EXPAND Variable verschoben
• no-suexec ist jetzt suexec
• static-modules ist jetzt static

Eine detaillierte Beschreibung der alten und entsprechenden neuen USE-Flags finden Sie unten.

2.  Upgraden von <2.0.52-r3

Einführung

Der Zustand des Apache und seiner Module innerhalb von Gentoo wurde langsam trostlos. Es gab eine Reihe von Problemen die den Support und die Pflege von allem, wofür das Apache Team verantwortlich ist, schwierig machten:

• Die Konfiguration, die mit Gentoo ausgeliefert wurde, unterschied sich enorm von einer regulären Konfiguration, die die meisten Benutzer erwarteten
• Viele Module haben einen ähnlichen Code verwendet, aber alle erledigten Dinge auf ihre eigene Art und Weise
• Die meisten Module wurden nicht besonders gut gepflegt, hauptsächlich wegen der großen Zahl der verfügbaren Module
• Es gab keinen Standard für die Konfiguration der Module
• Einige Module wären mit beiden Apache Versionen lauffähig gewesen, aber die Ebuilds haben das nicht berücksichtigt
• Einige Optionen die Apache bietet waren für Gentoo-Benutzer nicht verfügbar (zum Beispiel MPMs)
• Apache Bugs sammelten sich an

Dieses Dokument beschreibt, wie Sie Ihren Apache upgraden ohne ihr System kaputt zu machen. Wenn Sie ein Entwickler sind oder gerne wissen möchten, was wir geändert haben, oder wie Ebuilds angepasst werden müssen, um die Vorteile unserer Eclass nutzen zu können, sehen Sie sich die Apache Developer Reference an.

Upgraden

Es gab viele Änderungen daran, wie Apache unter Gentoo funktioniert. Jedes Paket, das im direkten Zusammenhang mit Apache steht, muss aktualisiert werden und einige Dinge, die bisher funktioniert haben, funktionieren jetzt nicht mehr.

Als erstes müssen Sie herausfinden welche Pakete ein Upgrade benötigen. Sie können das mit Hilfe des equery Tools, welches Bestandteil des app-portage/gentoolkit Pakets ist, feststellen.

$ 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

Viele Webapplikationen werden von diesem Upgrade nicht beeinflusst, da die meisten Webapplikationen die webapp Eclass benutzen, welche sich darum kümmert, dass diese richtig installiert werden. Sie sollten überprüfen ob es vielleicht eine neue Revision gibt.

Da wir einige neue USE-Flags eingeführt haben, möchten Sie vielleicht einen Blick darauf werfen und entsprechende Zeilen in ihre /etc/portage/package.use einfügen. Für weitere Informationen schauen Sie sich die von Apache unterstützten USE-Flags an.

(Prüfen Sie die USE-Flags und die nötigen Updates)
# 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

(Pakete aktualisieren)
# 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

(Möglicherweise ist es einfacher ein World-Update zu machen, anstelle
 des obenstehenden)

# emerge --ask --verbose --update --newuse --deep world

Nun müssen Sie Apache und seine Module neu konfigurieren. Beginnen Sie damit etc-update oder dispatch-conf auszuführen um die Dateien in /etc/init.d und /etc/conf.d zu aktualisieren. Sie werden feststellen, dass Ihre Apache Konfigurationsdateien nicht mit in der Liste der zu aktualisierenden Dateien erscheinen, dies liegt daran, dass sämtliche Apache Konfigurationsdateien nun an einem anderen Ort gespeichert werden.

Wenn Sie Änderungen an den alten apache.conf und commonapache.conf Standarddateien vorgenommen haben, müssen Sie diese Änderungen in die Datei /etc/apache{|2}/httpd.conf migrieren. Des Weiteren haben sich die Speicherorte für die Module und Virtual-Hosts geändert. Diese befinden sich nun in /etc/apache2/modules.d bzw. /etc/apache2/vhosts.d.

Wenn Sie damit fertig sind Ihre Änderungen in die neuen Dateien zu übertragen, müssen Sie die alten Konfigurationsdateien löschen (oder Sie an einen sicheren Ort verschieben). Das neue /etc/init.d/apache{|2} überprüft ob diese Dateien existieren und lässt Sie den Apache nicht starten bis Sie sie entfernt haben und so zeigen, dass Sie den Apache mit den neuen Pfaden rekonfiguriert haben.

Nun sollten Sie den Apache neustarten.

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

Wenn Sie irgendwelche Schwierigkeiten haben sehen Sie im Apache Troubleshooting Guide nach und, sollte sich dort keine Lösung finden, schreiben Sie einen Bugreport auf dem Gentoo Bugzilla. Denken Sie daran anzugeben welche Module Sie benutzen und (falls Sie Apache 2 nutzen) welches MPM USE-Flag Sie zum Kompilieren verwendet haben (wenn zutreffend). Sie können auch #gentoo-apache auf dem Server irc.freenode.net besuchen, um Hilfe zu ihren Problemen zu erfragen.

3.  Unterstütze USE-Flags in <2.2.6-r4

Es gibt einige spezifische USE-Flags für Apache und seine Module. Apache unterstützt darüber hinaus weitere, allgemeinere USE-Flags wie z.B. ssl, aber die Auswirkung unterscheidet sich kaum von der die diese USE-Flags an anderer Stelle haben, deshalb wurden diese USE-Flags nicht mit in die folgende Liste aufgenommen. Um eine vollständige Liste aller unterstützten USE-Flags zu erhalten führen Sie emerge --verbose --pretend apache aus.

4.  Unterstütze USE-Flags in 2.2.6-r4 und höher

Mit der Einführung von APACHE2_MODULES war ein generelles Aufräumen der USE-Flags erforderlich. Die folgende Tabelle listet alle unterstützten USE-Flags für apache-2.2.6-r4 und höher auf, ebenso das entsprechende Flag in älteren Versionen.

Die folgende Tabelle listet unterstützte APACHE2_MPMS seit apache-2.2.6-r4 und deren entsprechendes, vorheriges, lokales USE-Flag auf.

Die folgende Tabelle listet unterstützte APACHE2_MODULES seit apache-2.2.6-r4 auf.

Die Inhalte dieses Dokuments sind, sofern nicht explizit anders genannt, unter der Creative Commons - Namensnennung / Weitergabe Lizenz lizenziert. Die Gentoo Name and Logo Usage Guidelines treffen zu.