Aktualizacja Apache

1.  Aktualizacja wersji <2.2.6-r4

Ebuildy Apache przez długi czas korzystały z /etc/apache2/apache2-builtin-mods do wybierania modułów, które mają być skompilowane. Miało to jednak szereg wad.

• Wybór podczas pierwszej instalacji nie był możliwy.
• Portage nie wiedziało które moduły zostały już zainstalowane. Sprawiało to problemy szczególnie w przypadku prekompilowanych pakietów.
• Portage próbowało nadpisać plik apache2-builtin-mods przy każdej aktualizacji.

W celu naprawienia tej sytuacji zrezygnowaliśmy z pliku /etc/apache2/apache2-builtin-mods i zaczęliśmy korzystać ze zmiennych APACHE2_MODULES z USE_EXPAND. Poniższe polecenie pozwoli na przerobienie starego sposobu wyboru modułów na nowy:

$ 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

(Można teraz bezpiecznie zaktualizować apache)
# emerge -uva '>=www-servers/apache-2.2.6-r4'

Oprócz dodania zmiennej APACHE2_MODULES, dokonaliśmy także porządków we flagach USE.

• Wszystkie flagi USE MPM zostały przeniesione do zmiennej APACHE2_MPMS z USE_EXPAND
• no-suexec został zastąpiony przez suexec
• static-modules teraz nazywają się po prostu static

Dokładny opis wszystkich starych i nowych flag USE znajduje się poniżej.

2.  Aktualizacja z <2.0.52-r3

Wprowadzenie

Stan pakietów z Apache i jego modułami zaczął się pogarszać. Liczne problemy utrudniały pracę grupy opiekującej się Apache oraz pomoc użytkownikom:

• Konfiguracja dostarczana z Gentoo znacznie różniła się od domyślnej, jakiej oczekiwała większość użytkowników
• Wiele modułów używało podobnego kodu, ale robiło wszystko na swój sposób
• Większość modułów nie była dobrze zarządzana - przede wszystkim z powodu ich dużej ilości
• Moduły nie posiadały standardowej konfiguracji
• Niektóre moduły współpracowały z obiema wersjami Apache, ale ebuildy tego nie obsługiwały
• Niektóre funkcje Apache nie były dostępne dla użytkowników Gentoo (na przykład MPM)
• Błędy związane z Apache nawarstwiały się

Dokument ten szczegółowo opisuje bezpieczny dla systemu proces aktualizacji apache. Deweloperzy oraz zainteresowani zmianami użytkownicy, którzy chcieliby się dowiedzieć jak zmodyfikować ebuildy, żeby korzystały z nowej eclassy mogą znaleźć więcej informacji w Apache Developer Reference.

Aktualizowanie

Wprowadziliśmy wiele zmian w działaniu Apache pod Gentoo. Każdy pakiet, który jest z nim bezpośrednio związany, musi zostać zaktualizowany. Nie wszystko będzie działać tak jak wcześniej.

Po pierwsze, musimy dowiedzieć się, które pakiety należy zaktualizować. Możemy skorzystać w tym celu z programu equery, należącego do pakietu 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
net-www/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

Wprowadzone zmiany nie dotyczą wielu aplikacji internetowych, w większości korzystających z eclassy webapp, która kontroluje ich poprawną instalację. Można sprawdzić czy zostały zaktualizowane w nowej wersji pakietu.

Ponieważ dodaliśmy kilka nowych flag USE, warto je przejrzeć i dodać odpowiednie wpisy do /etc/portage/package.use. Więcej informacji znajduje się w rozdziale Flagi USE dotyczące Apache.

(Aby wyświetlić nowe flagi USE i niezbędne aktualizacje)
# 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

(Aby zaktualizować pakiety)
# 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

(Aktualizacja samego world może okazać się łatwiejsza)
# emerge --ask --verbose --update --newuse --deep world

Teraz musimy ponownie skonfigurować Apache oraz jego moduły. Zaczniemy od aktualizacji plików w /etc/init.d oraz /etc/conf.d za pomocą narzędzi etc-update lub dispatch-conf. Nie wyświetlą one plików konfiguracyjnych apache, ponieważ wszystkie zostały przeniesione do innych lokalizacji.

Jeśli wprowadziliśmy zmiany do domyślnych plików apache.conf oraz commonapache.conf, będziemy musieli je przepisać w /etc/apache{|2}/httpd.conf. Zmieniły się ścieżki do plików konfiguracyjnych modułów oraz vhostów. Obecnie znajdują się odpowiednio w katalogach /etc/apache2/modules.d oraz /etc/apache2/vhosts.d.

Kiedy skończymy przepisywać nasze zmiany do nowych plików konfiguracyjnych, musimy usunąć poprzednie (lub gdzieś je przenieść). Poprawiony /etc/init.d/apache{|2} nie pozwala uruchomić apache jeśli wciąż istnieją, zakładając, że ponownie skonfigurowaliśmy apache korzystając z nowych plików.

Następnie ponownie uruchamiamy apache.

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

Jeśli natrafimy na jakieś problemy, powinniśmy przeczytać Apache Troubleshooting Guide. Jeżeli nie znajdziemy tam rozwiązania, należy je zgłosić w bugzilli. W raporcie błędu trzeba wymienić używane moduły oraz (jeżeli korzystamy z Apache 2) flagi USE dotyczące MPM z jakich korzystamy. Pomoc można uzyskać także na kanale #gentoo-apache w sieci irc.freenode.net.

3.  Flagi USE dotyczące Apache

Apache i jego moduły korzystają z pewnych specyficznych flag USE. Oczywiście obsługują także bardziej standardowe flagi takie jak ssl, jednak nie opisujemy ich zachowania, ponieważ nie różni się znacznie od tego w innych pakietach. Wszystkie obsługiwane flagi można wyświetlić poleceniem emerge --verbose --pretend apache.

4.  Flagi USE wspierany w wersji 2.2.6-r4 i nowszych

Po wprowadzeniu APACHE2_MODULES porządki we flagach USE były koniecznością. Poniższa lista zawiera wszystkie wspierane flagi USE dla apache-2.2.6-r4 i nowszych oraz ich odpowiedniki w starszych wersjach.

Poniższa tabela zawiera wszystkie wspierane wartości zmiennej APACHE2_MPMS w apache-2.2.6-r4 i flagi USE które je reprezentowały w poprzednich wydaniach pakietu.

Poniższa lista zawiera wszystkie wspierane wartości zmiennej APACHE2_MODULES od wersji apache-2.2.6-r4.

Zawartość tego dokumentu jest rozpowszechniana na podstawie licencji Creative Commons - Attribution / Share Alike.