Aggiornamento di Apache

1.  Aggiornare dalle versioni <2.2.6-r4

Gli ebuild di Apache hanno utilizzato /etc/apache2/apache2-builtin-mods per moltissimo tempo per selezionare i moduli integrati durante la fase di compilazione. Tuttavia questa modalità ha diversi svantaggi:

• Non è possibile selezionare moduli integrati durante la fase iniziale di merge
• Portage non sa quali moduli sono stati installati. Ciò è fastidioso specialmente per i pacchetti binari.
• Portage tenterà di sovrascrivere apache2-builtin-mods ad ogni aggiornamento

Per rimediare a questa situazione /etc/apache2/apache2-builtin-mods è stato reso deprecato e migrato alla nuova variabile di tipo USE_EXPAND denominata APACHE2_MODULES. Per convertire la propria selezione personalizzata di moduli al nuovo formato usare il seguente comando:

$ 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

(Ora è possibile aggiornare apache in sicurezza:)
# emerge -uva '>=www-servers/apache-2.2.6-r4'

In aggiunta alla nuova variabile APACHE2_MODULES le flag USE locali sono state rimosse:

• Tutte le flag USE MPM sono state spostate nella variabile di tipo USE_EXPAND denominata APACHE2_MPMS
• no-suexec ora è diventata suexec
• static-modules ora è diventata static

Per una descrizione dettagliata delle vecchie e delle corrispondenti nuove flag USE vedere il capitolo seguente.

2.  Aggiornare dalle versioni <2.0.52-r3

Introduzione

Lo stato di Apache e dei suoi moduli in Gentoo stava peggiorando, in quanto c'era un certo numero di problemi che causavano problemi nel supporto e rendevano difficoltoso il mantenimento del pacchetto:

• La configurazione fornita con Gentoo era drasticamente diversa da quella distribuita da apache.org usata da molti utenti e distribuzioni.
• Molti moduli usavano porzioni di codice simili, ma ognuno di essi implementava funzioni in modo personale.
• Alcuni moduli non erano mantenuti con cura, a causa anche del grande numero di moduli disponibile
• I moduli non avevano una configurazione standard
• Alcuni moduli supportavano entrambe le versioni di Apache, ma gli ebuild non erano in grado di gestirlo
• Scelte disponibili normalmente in Apache non lo erano per gli utenti Gentoo (per esempio gli MPMs)
• I bug di Apache si stavano accumulando

Questo documento spiega come aggiornare senza danneggiare il proprio sistema. Se si è sviluppatori o si vuole sapere cosa è stato cambiato, o come gli ebuild devono essere modificati per utilizzare le eclass, visitare la guida di riferimento di Apache per gli Sviluppatori.

Aggiornare

Sono stati fatti molti cambiamenti riguardo il modo in cui Apache lavora all'interno di Gentoo. Ogni pacchetto direttamente collegato con Apache deve essere aggiornato, ed alcune cose che prima funzionavano, ora non funzioneranno più.

Prima di tutto bisogna capire cosa necessita di aggiornamento. Questo è possibile usando lo strumento equery, del pacchetto 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
net-www/mod_loopback-1.04
net-www/mod_watch-3.18
www-apps/viewcvs-0.9.2_p20030430

Molte applicazioni web non sono influenzate da questo aggiornamento perché si appoggiano alla eclass webapp che si occupa di garantirne la corretta installazione e funzionamento. È comunque consigliabile controllare la disponibilità di nuove revisioni.

Sono state aggiunte alcune nuove flag USE, è consigliabile rivedere il contenuto di /etc/portage/package.use. Consultare la lista delle flag USE di Apache per ulteriori dettagli.

(Verifica delle flag USE e degli aggiornamenti richiesti)
# 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

(Aggiornamento)
# 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

(È più semplice effettuare l'aggiornamento di world)
# emerge --ask --verbose --update --newuse --deep world

Ora bisogna riconfigurare Apache ed i suoi moduli. Si inizia con un etc-update o dispatch-conf per aggiornare i file in /etc/init.d e /etc/conf.d. Si riceverà la segnalazione che i file di configurazione di Apache sono stati aggiornati (questo perché tutti i file di configurazione sono stati spostati)

Se sono stati fatti dei cambiamenti al precedente apache.conf e commonapache.conf è necessario fare la migrazione di tali cambiamenti a /etc/apache{|2}/httpd.conf. Anche la locazione per moduli e virtual-host è stata cambiata: adesso si trovano rispettivamente in /etc/apache2/modules.d e /etc/apache2/vhosts.d.

Una volta completata la migrazione dei cambiamenti al nuovo file di configurazione, è necessario cancellare il vecchio file di configurazione (o spostarlo in una diversa posizione). Il nuovo script /etc/init.d/apache{|2} verifica che non esistano copie dei vecchi file, e non permette l'avvio di Apache fino a che questi file non sono stati rimossi, indicando l'avvenuta riconfigurazione di Apache usando i nuovi percorsi.

Ora è possibile riavviare apache.

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

Se si presentano dei problemi, consultare la guida per la Risoluzione dei problemi in Apache e se questa non risolve la questione, segnalare il problema su Gentoo Bugzilla. Assicurarsi di includere l'elenco dei moduli che sono stati abilitati e (se si usa Apache 2) quale MPM USE-flag è stata usata per la compilazione. È possibile trovare supporto anche nel canale IRC #gentoo-apache su irc.freenode.net.

3.  Flag USE supportate nelle versioni <2.2.6-r4

Ci sono alcuni flag USE locali per Apache ed i suoi moduli. Apache supporta molte altre flag USE generiche come ssl, ma l'effetto che hanno non è molto diverso da quello che manifestano in altri contesti, quindi non vengono incluse in questa lista. emerge --verbose --pretend apache mostra tutte le flag USE supportate.

4.  USE flag supportate nella versione 2.2.6-r4 e successive

Con l'avvento della variabile APACHE2_MODULES era necessaria una pulizia generale delle flag USE. La seguente tabella elenca le USE flag supportate da apache-2.2.6-r4 e versioni successive nonché le loro equivalenti per le versioni precedenti.

La tabella seguente elenca i valori supportati per la variabile APACHE2_MPMS in apache-2.2.6-r4 e la loro corrispondente USE flag locale precedente.

La tabella seguente elenca le variabili APACHE2_MODULES supportate a partire da apache-2.2.6-r4.

I contenuti di questo documento sono rilasciati sotto la licenza Creative Commons - Attribution / Share Alike.