Panduan Upgrade Apache

1.  Upgrade dari <2.2.6-r4

Ebuild apache telah menggunakan /etc/apache2/apache2-builtin-mods sejak lama untuk memilih modul-modul built-in selama proses kompilasi. Bagaimanapun juga, hal ini memiliki beberapa kekurangan:

• Memilih modul-modul built-in selama proses instalasi awal berlangusng tidak dapat dilakukan
• Portage tidak mengetahui modul apa saja yang telah terinstal. Hal ini akan sangat mengganggu, terutama untuk paket-paket binari
• Portage akan mencoba untuk menimpa apache2-builtin-mods pada setiap proses upgrade

Untuk mengatasi masalah ini, /etc/apache2/apache2-builtin-mods telah dianggap usang dan diganti dengan variabel APACHE2_MODULES dan USE_EXPAND. Untuk mengkonversi pemilihan modul-modul yang telah anda lakukan ke format yang baru, jalankan perintah berikut:

$ 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

(Sekarang anda dapat meng-upgrade apache dengan aman:)
# emerge -uva '>=www-servers/apache-2.2.6-r4'

Sebagai tambahan untuk APACHE2_MODULES flag USE lokal telah dihapuskan:

• Semua flag USE MPM telah dipindahkan ke variabel APACHE2_MPMS dan USE_EXPAND
• no-suexec sekarang menjadi suexec
• static-modules menjadi static

Untuk mendapatkan penjelasan yang lebih lengkap tentang flag-flag USE lama dan penggantinya, bacalah bagian ini.

2.  Upgrade dari <2.0.52-r3

Pendahuluan

Keberadaan Apache dan modul-modulnya di gentoo telah menjadi suram. Ada beberapa masalah yang dapat menyebabkan masalah dukungannya menjadi lebih sulit:

• Konfigurasi yang digunakan oleh Gentoo sangat jauh berbeda dengan konfigurasi dari pusat dan yang diperkirakan oleh user
• Banyak modul yang menggunakan kode yang mirip, tetapi melakukan tugasnya masing-masing dengan cara yang berbeda
• Kebanyakan modul tidak diurus dengan benar - biasanya karena banyaknya jumlah modul yang ada
• Tidak adanya standar untuk konfigurasi modul
• Sebagian modul dapat mendukung kedua versi Apache, tetapi ebuild tidak dapat menanganinya
• Pilihan-pilihan yang tersedia di Apache tidak tersedia untuk pengguna Gentoo (misalnya MPM)
• Bug-bug Apache semakin bertambah

Dokumen ini berisi cara-cara meng-upgrade Apache tanpa merusak sistem anda. Jika anda adalah pengembang atau ingin mengetahui apa saja yang telah berubah, atau bagaimana sebuah ebuild perlu dimodifikasi agar dapat memanfaatkan eclass kami, bacalah Referensi Pengembang Apache.

Upgrade

Telah banyak perubahan dalam hal cara kerja Apache di Gentoo. Setiap paket yang berhubungan langsung dengan Apache perlu di-update dan akan ada beberapa hal yang tadinya berfungsi jadi tidak berfungsi lagi.

Pertama anda perlu mengetahui paket-paket apa saja yang perlu anda upgrade. Anda dapat melakukannya dengan menggunakan tool equery yang merupakan bagian dari paket 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

Banyak aplikasi web yang tidak terpengaruh sama sekali karena kebanyakannya menggunakan eclass webapp yang telah menangani instalasinya. Anda mungkin perlu mengecek untuk mengetahui apakah sudah ada revisi baru.

Karena kami telah menambahkan beberapa flag USE baru, anda mungkin perlu memeriksanya kembali dan menambahkan baris-baris yang diperlukan di file /etc/portage/package.use. Bacalah Flag-flag USE yang didukung oleh Apache untuk mendapatkan keterangan yang lebih lengkap.

(Periksa flag USE dan update-update yang diperlukan)
# 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

(Update paket)
# 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

(Mungkin akan lebih mudah untuk mengupdate world sekaligus ketimbang
update seperti di atas)
# emerge --ask --verbose --update --newuse --deep world

Sekarang anda perlu mengkonfigurasi ulang Apache dan modul-modulnya. Mulailah dengan etc-update atau dispatch-conf untuk meng-update file /etc/init.d dan /etc/conf.d. Anda akan melihat bahwa file-file konfigurasi apache anda tidak akan ditampilkan pada proses update - hal ini terjadi karena semua file-file konfigurasi telah dipindahkan.

Jika anda sebelumnya telah membuat perubahan pada file apache.conf dan commonapache.conf yang asli, anda perlu melakukan migrasi perubahan anda ke /etc/apache{|2}/httpd.conf. Konfigurasi untuk modul-modul dan virtual host juga telah dipindahkan -- semuanya sekarang terletak di /etc/apache2/modules.d dan /etc/apache2/vhosts.d.

Ketika anda telah selesai dengan migrasi, anda perlu menghapus file-file konfigurasi lama (atau memindahkannya ke sebuah lokasi yang aman). File /etc/init.d/apache{|2} yang baru akan memeriksa file-file ini dan tidak akan mengizinkan anda untuk menjalankan apache sebelum anda menghapusnya, yang menandakan bahwa anda telah mengkonfigurasi ulang apache dengan path-path yang baru.

Sekarang anda boleh me-restart apache.

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

Jika anda mendapatkan masalah, silakan baca Panduan Pemecahan Masalah Apache dan jika anda belum mendapatkan solusinya, silakan buat laporan di Bugzilla Gentoo. Jangan lupa untuk mencantumkan modul-modul apa saja yang telah anda aktifkan dan (jika anda menggunakan Apache 2) flag USE MPM apa saja yang telah anda gunakan ketika kompilasi (jika ada). Anda juga dapat bergabung dengan kami di channel #gentoo-apache di irc.freenode.net untuk mendapatkan bantuan.

3.  Flag-flag USE yang didukung oleh Apache <2.2.6-r4

Ada beberapa flag USE yang digunakan secara lokal oleh apache dan modul-modulnya. Apache mendukung beberapa flag USE biasa lainnya seperti ssl, tetapi pengaruhnya terhadap apache tidak terlalu berbeda dengan pengaruhnya terhadap paket-paket lain, jadi flag yang seperti itu tidak kami cantumkan pada daftar di bawah ini. Jalankan emerge --verbose --pretend apache untuk melihat daftar lengkap flag USE yang didukung oleh apache.

4.  Flag-flag yang didukung di 2.2.6-r4 dan versi setelahnya

Dengan penambahan variabel APACHE2_MODULES, maka diperlukan adanya pembersihan flag-flag USE. Tabel berikut ini berisi daftar flag USE yang didukung oleh apache-2.2.6-r4 dan versi setelahnya, dengan persamaannya di versi-versi sebelumnya.

Tabel berikut ini berisi APACHE2_MPMS yang didukung sejak apache-2.2.6-r4 bersama flag USE lokal pada versi-versi terdahulu.

Tabel berikut ini berisi flag USE yang didukung oleh APACHE2_MODULES sejak apache-2.2.6-r4.

Isi dokumen ini dilisensikan dengan lisensi Creative Commons - Attribution / Share Alike.