Mengapa Nginx Web Server?

Nginx Web Server sangat powerful dan jauh lebih hemat RAM dibandingkan Apache ketika melayani file statik seperti file gambar atau pun html, oleh sebab itu Nginx menjadi preferensi bagi website / aplikasi dengan traffic / load tinggi, baik berjalan sendiri maupun dipadukan dengan web server lain seperti Apache.

Mengapa Apache mod_wsgi?

Mod_wsgi memiliki overhead sampai dengan 50% lebih ringan dibandingkan mod_python, dan jauh lebih ringan dibandingkan CGI untuk menjalankan script python pada Web Server Apache. Dokumentasi teknis mengenai benchmark ini dapat dipelajari lebih lanjut di http://code.google.com/p/modwsgi/wiki/PerformanceEstimates. Atau melalui link berikut untuk perbandingan di aplikasi yang sudah berjalan http://collingrady.wordpress.com/2009/01/06/mod_python-versus-mod_wsgi/.

Mengapa Ubuntu?

Ubuntu apabila dibandingkan dengan distribusi linux lainnya memiliki kompilasi paket yang lebih maju, sebagai ilustrasi, versi python pada Ubuntu 9.04 adalah Python 2.6.2, sementara pada CentOS 5.3 memiliki versi Python 2.4.3. Hal ini merupakan salah satu alasan untuk menggunakan Ubuntu apabila anda membutuhkan dukungan Python dengan versi lebih baru. Karena pada semua distribusi Linux Python merupakan core software yang sangat sulit (atau tidak bisa) untuk diupgrade secara manual. Namun demikian, Django mendukung Python 2.3.x (dukungan terhadap Python 2.3.x akan ditarik oleh Django dalam waktu dekat) sehingga tetap tidak menjadi masalah apabila anda menggunakan CentOS untuk mendeploy aplikasi anda.

Update Ubuntu

Masukkan repository universe pada sources.list anda.

sudo nano /etc/apt/sources.list

Sesuaikan dengan isi file anda, seperti contoh berikut;

deb http://ubuntu.indika.net.id jaunty main universe
deb http://security.ubuntu.com/ubuntu jaunty-security main universe

Update Ubuntu

sudo aptitude update

Instalasi Build Essential

sudo aptitude install build-essential

Instalasi Apache dan mod_wsgi

sudo aptitude install apache2 apache2.2-common apache2-mpm-worker apache2-threaded-dev libapache2-mod-wsgi python-dev

Konfigurasi Apache

Sesuaikan direktif timeout dan matikan KeepAlive

sudo nano /etc/apache2/apache2.conf

Timeout 60
KeepAlive Off

Modifikasi konfigurasi security di conf.d (opsional)

sudo nano /etc/apache2/conf.d/security

ServerTokens Prod
ServerSignature Off
TraceEnable Off

Restart Apache

sudo apache2ctl graceful

Hapus default site bawaan dari instalasi awal

sudo a2dissite 000-default

Ubah port listening dan port virtual host Apache menjadi 8080, Nginx yang akan melayani port 80, sementara request untuk script Python akan di proxy ke port 8080 (Apache);

sudo nano /etc/apache2/ports.conf

NameVirtualHost *:8080
Listen 8080

Restart Apache

sudo apache2ctl graceful

Instalasi Nginx

sudo aptitude install nginx

Instalasi dengan menggunakan aptitude akan membuat file konfigurasi berada di /etc/nginx. Pada Ubuntu 9.04, versi Nginx yang digunakan adalah 0.6.35, sementara versi stable terbaru pada saat tulisan ini dibuat adalah 0.7.61, anda bisa melakukan kompilasi sendiri apabila anda membutuhkan Nginx dengan versi yang lebih baru.

Start Nginx

sudo /etc/init.d/nginx start

Hapus konfigurasi default virtual host dari Nginx

sudo rm -f /etc/nginx/sites-enabled/default

Layout Nginx hasil instalasi ini mirip dengan Apache, untuk Virtual Host anda akan memiliki dua direktori yaitu sites-available dan sites-enabled, di dalam sites-enabled (seperti halnya Apache di Ubuntu) berisi symbolic link ke file yang berada di dalam sites-available. File konfigurasi virtual host sites-enabled ini yang nantinya akan ikut dipanggil ketika Nginx dijalankan.

Sesuaikan konfigurasi utama Nginx

sudo nano /etc/nginx/nginx.conf

di root konfigurasi

worker_processes  4;     <--- sesuaikan dengan jumlah core di dalam server anda

di dalam http {}

keepalive_timeout  2;
tcp_nopush on;

gzip_comp_level 2;
gzip_proxied any;
gzip_types text/plain text/html text/css application/x-javascript text/xml application/xml application/xml+rss text/javascript;

Buat file proxy.conf yang akan dipanggil oleh konfigurasi Virtual Host Nginx.

sudo nano /etc/nginx/proxy.conf

proxy_redirect              off;
proxy_set_header            Host $host;
proxy_set_header            X-Real-IP $remote_addr;
proxy_set_header            X-Forwarded-For $proxy_add_x_forwarded_for;
client_max_body_size        10m;
client_body_buffer_size     128k;
proxy_connect_timeout       90;
proxy_send_timeout          90;
proxy_read_timeout          90;
proxy_buffer_size           4k;
proxy_buffers               4 32k;
proxy_busy_buffers_size     64k;
proxy_temp_file_write_size  64k;

Restart Nginx

sudo /etc/init.d/nginx restart

Instalasi Subversion

Kita membutuhkan subversion karena Django yang akan kita gunakan adalah versi SVN.

sudo aptitude install subversion

Instalasi Django

Pada Python 2.6 di Ubuntu, modul tambahan tidak lagi di letakkan di sites-package, melainkan di dist-packages, hal ini mungkin akan membingungkan bagi anda yang terbiasa menggunakan Python ver 2.5 ke bawah.

cd /usr/lib/python2.6/dist-packages
sudo svn co http://code.djangoproject.com/svn/django/tags/releases/1.0.2/django django
sudo ln -s /usr/lib/python2.6/dist-packages/django/bin/django-admin.py /usr/local/bin/django-admin.py

Menyiapkan Virtual Host

Layout direktori berikut dapat disesuaikan dengan selera kita, pada intinya kita akan menyiapkan direktori untuk Nginx (Media Files), Apache (handler WSGI) dan untuk aplikasi Django kita yang dibuat melalui django-admin.py startproject <namaproject>. Sesuaikan semua keterangan di dalam <keterangan> dengan kondisi anda.

cd ~
mkdir /home/<username>/public_html
mkdir -p /home/<username>/public_html/<domain name>
mkdir -p /home/<username>/public_html/<domain name>/private
mkdir -p /home/<username>/public_html/<domain name>/logs

Aplikasi Django kita akan berada di dalam /home/<username>/public_html/<domain name>

Berikan permission kepada web server (baik Nginx maupun Apache akan berjalan sebagai user www-data), tambahkan username kita atau yang akan digunakan ke dalam group web server / www-data

sudo usermod -a -G www-data <username>

Ubah group ownership dari layout direktori dan berikan permission yang sesuai seperti contoh berikut;

sudo chgrp -R www-data /home/<username>/public_html
sudo chmod -R 2750 /home/<username>/public_html
sudo chmod -R 2770 /home/<username>/public_html/<domain name>/private

Instalasi Aplikasi Django

Start Django project, atau pindahkan file anda apabila sudah ada

cd /home/<username>/public_html/<domain name>
django-admin.py startproject <django_project_name>

Buat file .wsgi yang akan dipanggil oleh Apache mod_wsgi

mkdir -p /home/<username>/public_html/<domain name>/<django project name>/apache
cd /home/<username>/public_html/<domain name>/<django project name>/apache
sudo nano <django project name>.wsgi

import os, sys

apache_configuration= os.path.dirname(__file__)
project = os.path.dirname(apache_configuration)
workspace = os.path.dirname(project)
sys.path.append(workspace) 

sys.path.append('/usr/lib/python2.6/dist-packages/django/')
sys.path.append('/home/<username>/public_html/<domain name>/<django project name>')

os.environ['DJANGO_SETTINGS_MODULE'] = '<django project name>.settings'
import django.core.handlers.wsgi
application = django.core.handlers.wsgi.WSGIHandler()

Buat symbolic link untuk file media interface admin

sudo ln -s /usr/lib/python2.6/dist-packages/django/contrib/admin/media /home/<username>/public_html/<domain name>/<django project name>/media/admin]

Sesuaikan settings.py untuk Django Project anda

sudo nano settings.py

ADMIN_MEDIA_PREFIX = '/media/admin/'
.
.
.
MIDDLEWARE_CLASSES = (
'django.middleware.http.SetRemoteAddrFromForwardedFor',
)

Virtual Host Nginx

sudo nano /etc/nginx/sites-available/<namadomainanda.com>

upstream backend {
 server 127.0.0.1:8080;
}

server {
 listen   <ip.address.anda>:80;
 server_name www.<domain name> <domain name>;

 access_log /home/<username>/public_html/<domain name>/logs/nginx_access.log;
 error_log /home/<username>/public_html/<domain name>/logs/nginx_error.log;

 location / {
 proxy_pass  http://backend;
 include     /etc/nginx/proxy.conf;
 }

 location  /media/ {
 root /home/<username>/public_html/<domain name>/<django project name>/;
 }
}

Aktifkan konfigurasi Virtual Host tersebut dan restart Nginx

sudo ln -s /etc/nginx/sites-available/<domain name> /etc/nginx/sites-enabled/<domain name>
sudo /etc/init.d/nginx restart

Virtual Host Apache

sudo nano /etc/apache2/sites-available/<domain name>

<VirtualHost *:8080>
 #Basic setup
 ServerAdmin <admin email>
 ServerName www.<domain name>
 ServerAlias <domain name>

 <Directory /home/<username>/public_html/<domain name>/<django project name>/apache/>
 Order deny,allow
 Allow from all
 </Directory>

 LogLevel warn
 ErrorLog  /home/<username>/public_html/<domain name>/logs/apache_error.log
 CustomLog /home/<username>/public_html/<domain name>/logs/apache_access.log combined

 WSGIDaemonProcess <domain name> user=www-data group=www-data threads=25
 WSGIProcessGroup <domain name>

 WSGIScriptAlias / /home/<username>/public_html/<domain name>/<django project name>/apache/<django project name>.wsgi
</VirtualHost>

Aktifkan konfigurasi tersebut dan restart Apache

sudo a2ensite <domain name>
sudo /etc/init.d/apache2 reload

Reload WSGI Daemon Mode

Konfigurasi di atas akan menjalankan mod_wsgi dalam moda Daemon, dengan demikian apabila anda melakukan perubahan script, silahkan di touch file .wsgi nya agar group proses wsgi akan direload ulang, dengan demikian anda tidak perlu mereload / restart Apache setiap terjadi perubahan script.

sudo touch /home/<username>/public_html/<domain name>/<django project name>/apache/<djangoproject>.wsgi

Referensi

• http://www.meppum.com/2009/jan/17/installing-django-ubuntu-intrepid/
• http://code.google.com/p/modwsgi/

Mod Python

Install Apache dan Python Module

Yum package management akan secara otomatis melakukan instalasi Apache 2.2.3 melalui perintah dibawah ini;

yum install -y mod_python subversion wget

Selain instalasi httpd dan mod_python, kita juga melakukan instalasi subversion untuk melakukan instalasi django.

Masukkan service httpd pada startup list; dan start service httpd;

chkconfig httpd on
service httpd start

Pada CentOS 5.2, Python Module untuk apache akan dipanggil oleh file /etc/httpd/conf.d/python.conf

#
# Mod_python is a module that embeds the Python language interpreter
# within the server, allowing Apache handlers to be written in Python.
#
LoadModule python_module modules/mod_python.so

Install Django SVN

mkdir /opt/django
cd /opt/django/
svn co http://code.djangoproject.com/svn/django/trunk/

Setelah proses checkout SVN selesai, maka django telah terinstall, yang harus kita lakukan kemudian adalah memberitahukan python mengenai instalasi django yang baru saja kita lakukan. Hal ini dilakukan dengan membuat symbolic link path instalasi django ke direktori site package milik Python.

ln -s /opt/django/trunk/django /usr/lib/python2.4/site-packages

Kemudian kita membuat symbolic link django-admin.py ke dalam system CentOS agar bisa dipanggil dari direktori mana saja.

ln -s /opt/django/trunk/django/bin/django-admin.py /usr/local/bin/django-admin.py

Tes instalasi django, jika perintah berikut tidak mengembalikan pesan error maka instalasi django anda sudah berhasil, apabila masih ada kesalahan, periksa ulang perintah untuk memasukkan path django ke dalam path site package Python.

python
>>> import django

Instalasi Database Server MySQL dan Python Module 1.2.2

Ikauti langkah-langkah instalasi database server MySQL dan Python Module 1.2.2 pada artikel http://artikel.magnet-id.com/knowledge-base/vps-knowledge-base/menggunakan-mysqldb-untuk-aplikasi-django/ , hal ini harus dilakukan secara manual, karena python adapter untuk MySQL dari CentOS 5.2 yum masih pada versi 1.2.1 sementara django membutuhkan versi 1.2.1p5 ke atas.

Membuat Direktori Template dan Aplikasi

Berbeda dengan PHP, django di deploy tanpa menempatkan source file template dan aplikasi di document root web server, django kemdian akan melakukan pemetaan URL melalui Django URL Resolver. Untuk memudahkan proses development nantinya, kita akan membuat user di luar root terlebih dahulu;

Install sudo

yum install -y wget sudo

Buat username dan berikan password

adduser username
passwd usename

Berikan akses sudo kepada user terkait

visudo

Tambahkan baris berikut;

username ALL=(ALL) ALL

Save dan exit visudo

:wq

Su ke user tersebut dan pindah ke home direktori user;

su username
cd ~

Ubah username dengan nama user yang anda buat, buat direktori djangoapps (untuk aplikasi dan project anda nantinya) dan djangowww untuk file media dan template.

mkdir djangoapps
mkdir djangowww
mkdir djangowww/template
mkdir djangowww/media

Buat test project;

cd djangoapps/
django-admin.py startproject testapp
exit

Ubah permission home direktori user agar dapat diakses oleh Apache kemudian dan tidak memunculkan Forbidden 403 Error;

cd /home/
chmod 711 username/

Membuat Egg Cache

Kemudian siapkan direktori untuk menyimpan Python Egg Cache dan pastikan bahwa web server memiliki hak tulis ke direktori tersebut, dalam hal ini adalah /var/cache/.

mkdir -p /var/cache/www/pythoneggs
chown apache /var/cache/www/pythoneggs

Konfigurasi Virtual Host Apache

Pada bagian ini kita akan menambahkan sebuah virtual host di Apache, yang nantinya domain pada virtual host tersebut akan berjalan di atas aplikasi django yang akan kita kembangkan.

Buat konfigurasi Virtual Host di file /etc/httpd/conf.d/vhosts.conf yang akan diload oleh Apache pada saat startup.

vi /etc/httpd/conf.d/vhosts.conf

Masukkan baris berikut, bisa ditambahkan atau dikurangi kemudian sesuai dengan kebutuhan anda; Gantikan username, tesdomain.com dan testapp dengan konfigurasi anda.

NameVirtualHost *:80
<VirtualHost *:80>
  ServerName tesdomain.com
  DocumentRoot "/home/username/djangowww/"
  # Menambahkan www. untuk domain (optional) #
  RewriteEngine On
  RewriteCond %{HTTP_HOST} ^tesdomain\.com [NC]
  RewriteRule (.*) http://www.tesdomain.com$1 [R=301,L]
  # Django stuff #
  <Location "/">
  SetHandler python-program
  PythonHandler django.core.handlers.modpython
  PythonPath "['/home/username/djangoapps/'] + sys.path"
  SetEnv DJANGO_SETTINGS_MODULE testapp.settings
  SetEnv PYTHON_EGG_CACHE "/var/cache/www/pythoneggs"
  PythonDebug On
</Location>
# Static media: images, css, etc. #
<Location "/media/">
  SetHandler None
</Location>
</VirtualHost>

Save dan Exit; kemudian restart httpd;

:wq
service httpd restart

Tes setup virtual host anda; Apabila konfigurasi virtual host apache dan django sudah dilakukan dengan benar maka akan muncul gambar seperti berikut;

Default Page Django

Aplikasi Django anda sudah siap untuk dikembangkan dengan menggunakan Apache Web Server.

Referensi

• http://docs.djangoproject.com/en/dev/topics/install/
• http://fosswire.com/2008/05/19/installing-mod_python-and-django-on-apache/
• http://artikel.magnet-id.com/knowledge-base/vps-knowledge-base/menggunakan-mysqldb-untuk-aplikasi-django/