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/

Instalasi akan dilakukan pada mesin dengan Operating System CentOS 64 bit, sebagai contoh kasus adalah VPS yang disediakan oleh Magnet Hosting. Harus diperhatikan bahwa langkah berikut dilakukan pada system yang telah memilki instalasi dan konfigurasi Nginx yang telah berjalan dengan baik.

Instalasi Ruby

Berikut software package ruby yang harus diinstall terlebih dahulu;

yum install -y ruby ruby-devel rdoc

Kemudian lakukan kompilasi Ruby Gems dari Rubyforge.

cd /usr/src/
wget wget http://www.magnet-id.com/download/framework/ror/rubygems/rubygems-1.3.3.tgz
tar xzvf rubygems-1.3.3.tgz
cd rubygems-1.3.3
ruby setup.rb

Juga lakukan instalasi rake dan fastthread

gem install rake
gem install fastthread

Instalasi Passenger

Download source file passenger

cd /usr/src/
wget http://www.magnet-id.com/download/Apache/passenger-2.2.2.tar.gz
tar xzvf passenger-2.2.2.tar.gz
cd passenger-2.2.2
./bin/passenger-install-nginx-module

Script diatas akan memandu proses instalasi modul passenger, apabila nginx anda disetup dan dikonfigurasi berdasarkan panduan yang ada di http://artikel.magnet-id.com/knowledge-base/vps-knowledge-base/nginx-mysql-php-di-centos-52-64-bit/,  silahkan ikuti langkah berikut;

Automatically download and install Nginx?
...

Do you want this installer to download, compile and install Nginx for you?

1. Yes: download, compile and install Nginx for me. (recommended)
...
2. No: I want to customize my Nginx installation. (for advanced users)
...
Whichever you choose, if you already have an existing Nginx configuration file,
then it will be preserved.

Pilih no.2 pada pertanyaan di atas; panduan instalasi akan dilanjutkan, silahkan perhatikan jawaban yang sudah dimasukkan ke dalam teks berikut, sesuai dengan artikel instalasi Nginx;

Where is your Nginx source code located?
Please specify the directory: /usr/local/src/nginx-0.6.36

Where do you want to install Nginx to?
Please specify a prefix directory [/opt/nginx]: /usr/local/nginx
--------------------------------------------
Extra Nginx configure options

If you want to pass extra arguments to the Nginx 'configure' script, then
please specify them. If not, then specify nothing and press Enter.

If you specify nothing then the 'configure' script will be run as follows:

./configure --prefix='/usr/local/nginx' --add-module='/usr/src/passenger-2.2.2/ext/nginx'

Extra arguments to pass to configure script: --pid-path=/usr/local/nginx/logs/nginx.pid --sbin-path=/usr/local/sbin/nginx --with-md5=/usr/lib --with-sha1=/usr/lib --with-http_ssl_module  --with-http_dav_module --without-mail_pop3_module --without-mail_imap_module --without-mail_smtp_module

--------------------------------------------

Apabila kompilasi ulang berhasil, anda akan mendapatkan pesan berikut;

Nginx with Passenger support was successfully installed.

Please edit your Nginx configuration file (probably /usr/local/nginx/conf/nginx.conf),
and set the passenger_root and passenger_ruby configuration options in the
'http' block, like this:

  http {
      ...
      passenger_root /usr/src/passenger-2.2.2;
      passenger_ruby /usr/bin/ruby;
      ...
  }

Konfigurasi Nginx

Untuk mengaktifkan passenger, silahkan tambahkan direktif

      passenger_root /usr/src/passenger-2.2.2;
      passenger_ruby /usr/bin/ruby;

Di dalam tag http {}

Kemudian di dalam direktif server {} silahkan ditambahkan

root /somewhere/public;   # <--- be sure to point to 'public'!
passenger_enabled on;

Mesin cPanel menggunakan Apache sebagai HTTP Server, sebelum melakukan instalasi, pastikan bahwa versi Apache yang digunakan oleh cpanel anda adalah versi 2.x. Hal ini dapat dilakukan melalui fasilitas easyapache di WHM, apabila belum, silahkan lakukan upgrade melalui fasilitas yang disediakan oleh easyapache.

cPanel sebenarnya telah mendukung aplikasi Ruby dan RoR dengan menggunakan Mongrel. Namun Phusion Passenger yang dapat dijalankan sebagai modul Apache menawarkan kelebihan yang dapat anda pelajari lebih lanjut di situs http://www.modrails.com/.

Instalasi Ruby dan Ruby on Rails

Lakukan instalasi Ruby dan Ruby on Rails terlebih dahulu.

/scripts/installruby
/usr/local/cpanel/bin/ror_setup

Instalasi Phusion Passenger

gem install passenger
cd /usr/local/bin/
ln -s /usr/local/apache/bin/apxs
ln -s /usr/local/apache/include/ /usr/include/apr-1
export APR_CONFIG=/usr/local/apache/bin/apr-1-config
export APU_CONFIG=/usr/local/apache/bin/apu-1-config

Install Passenger sebagai modul Apache;

passenger-install-apache2-module

Konfigurasi Apache

Masukkan direktif berikut pada file /usr/local/apache/conf/includes/pre_virtualhost_global.conf (buat terlebih dahulu filenya);

vi /usr/local/apache/conf/includes/pre_virtualhost_global.conf

Masukkan;

LoadModule passenger_module /usr/lib/ruby/gems/1.8/gems/passenger-2.2.2/ext/apache2/mod_passenger.so
PassengerRoot /usr/lib/ruby/gems/1.8/gems/passenger-2.2.2
PassengerRuby /usr/bin/ruby

Restart httpd server cpanel

/scripts/restartsrv_httpd

Passenger sudah terinstall sebagai modul pada Apache anda.

Deployment Ruby on Rails Application

Untuk menjalankan aplikasi RoR, silahkan upload aplikasi anda ke home direktori user terkait, jalankan setup dan buat ulang public_html user terkait sebagai symbolic link ke folder public aplikasi yang ingin dijalankan.

Phusion Passenger

Artikel berikut akan menguraikan langkah demi langkah instalasi dan konfigurasi pada sebuah mesin cPanel yang telah berjalan dengan baik di Operating System CentOS 5.2 x86_64.

Instalasi Ruby dan RubyGems

Pada cPanel hal ini dapat dilakukan dengan menggunakan script yang disediakan;

/scripts/installruby
/usr/local/cpanel/bin/ror_setup

Script tersebut akan melakukan instalasi Ruby, RubyGems, Mongrel dan mengaktifkan interface Ruby pada cPanel masing-masing account di dalam server anda. Script ror_setup akan melakukan setup Ruby on Rails dan akan mengaktifkan begitu sistem di start.

Instalasi Phusion Passenger

Jalankan perintah-perintah berikut;

gem install passenger
cd /usr/local/bin/
ln -s /usr/local/apache/bin/apxs
ln -s /usr/local/apache/include/ /usr/include/apr-1
export APR_CONFIG=/usr/local/apache/bin/apr-1-config
export APU_CONFIG=/usr/local/apache/bin/apu-1-config

Lakukan instalasi Phusion Passenger sebagai modul Apache;

passenger-install-apache2-module

Instalasi Ruby Enterprise Edition (REE)

Download file isntaller REE dan jalankan script installer yang disediakan; Sesuaikan keterangan versi dengan versi yang anda gunakan;

cd /usr/src/

http://www.magnet-id.com/download/framework/ror/ruby-enterprise/ruby-enterprise-1.8.6-20090113.tar.gz

tar xzvf ruby-enterprise-1.8.6-20090113.tar.gz
./ruby-enterprise-1.8.6-20090113/installer

Ikuti instruksi pada saat menjalankan script installer dan pelajari keterangan yang disediakan.

Konfigurasi Apache

Apache kemudian harus dikonfigurasi agar menggunakan module Phusion Passenger. Edit file konfigurasi Apache anda, dan pastikan bahwa cpanel mengaktifkan penambahan konfigurasi tersebut;

vi /usr/local/apache/conf/httpd.conf

Tambahkan baris berikut; Sesuaikan dengan folder instalasi Ruby Enterprise Edition anda;

LoadModule passenger_module /opt/ruby-enterprise-1.8.6-20090113/lib/ruby/gems/1.8/gems/passenger-2.0.6/ext/apache2/mod_passenger.so
PassengerRoot /opt/ruby-enterprise-1.8.6-20090113/lib/ruby/gems/1.8/gems/passenger-2.0.6
PassengerRuby /opt/ruby-enterprise-1.8.6-20090113/bin/ruby

Simpan file tersebut dan pastikan bahwa cPanel mengaktifkan tambahan tersebut.

/usr/local/cpanel/bin/apache_conf_distiller --update
/usr/local/cpanel/bin/build_apache_conf
/scripts/restartsrv_httpd

Deployment Aplikasi RoR

Untuk mulai mengembangkan aplikasi RoR di server anda, silahkan buat user account yang memilki akses shell; Pindah ke account tersebut dengan menggunakan su.

Sesuaikan keterangan username dengan username yang telah anda buat melalui WHM. Dalam contoh ini kita akan membuat folder rails di dalam home direktori username.

su username
cd ~
mkdir rails && cd rails
rails testapp
ln -s  /home/username/rails/testapp/public/ /home/username/public_html
exit

Tambahkan konfigurasi virtual host untuk domain tersebut, sesuaikan username dan domain_name.

mkdir -p /usr/local/apache/conf/userdata/std/2/username/domain_name/
touch /usr/local/apache/conf/userdata/std/2/username/domain_name/rails.conf

Masukkan keterangan berikut pada file rails.conf, sesuaikan dengan folder yang anda gunakan di dalam public_html;

RailsBaseURI /public

Panggil rails.conf tersebut di konfigurasi Virtual Host Apache milik domain terkait. Edit file httpd.conf;

vi /usr/local/apache/conf/httpd.conf

Masukkan keterangan include di dalam tag VirtualHost domain terkait.

Include "/usr/local/apache/conf/userdata/std/2/username/domain_name/*.conf"

Aktifkan kedalam konfigurasi cPanel dan restart httpd;

/usr/local/cpanel/bin/apache_conf_distiller --update
/usr/local/cpanel/bin/build_apache_conf
/scripts/restartsrv_httpd

Untuk merestart aplikasi dapat dilakukan dengan merestart Apache atau dengan membuat file restart.txt di dalam folder tmp aplikasi terkait;

touch /home/username/rails/testapp/tmp/restart.txt

Jangan menggunakan fasilitas Ruby on Rails yang terdapat di dalam cPanel, karena hal ini akan mengaktifkan konfigurasi Mongrel di account terkait.

Referensi

• cPanel – Ruby on Rails http://www.cpanel.net/docs/ror/index.html
• Phusion Passenger http://www.modrails.com/
• Ruby Enterprise Edition (REE) http://www.rubyenterpriseedition.com/
• http://bobcares.com/index.php/blog/?p=174

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/

Django rilis stabil saat ini (0.96.2) mengharuskan anda untuk melakukan instalasi / kompulasi MySQLdb python module ver. 1.2.2 secara manual karena paket yang disediakan oleh yum package management baru pada versi 1.2.1 sementara yang dibutuhkan adalah versi 1.2.1p2 ke atas.

Instalasi Paket yang dibutuhkan

Beberapa paket development dibutuhkan untuk instalasi MySQLdb python module secara manual di langkah berikutnya.

yum install mysql mysql-server mysql-devel python-devel gcc cpp zlib-devel openssl-devel -y

Jalankan service MySQL dan masukkan ke dalam daftar service yang dimulai ketika mesin anda di reboot.

service mysqld start
chkconfig --levels 235 mysqld on
mysql_secure_installation

Create database yang ingin anda gunakan, create user untuk database tersebut apabila diperlukan.

mysql -u root -p
mysql>create database namadatabase;
mysql>quit

Instalasi MySQLdb Python Module 1.2.2

Hal ini dilakukan karena adapter database mysql untuk Django mengharuskan anda menggunakan MySQLdb versi 1.2.1p2 ke atas sementara versi instalasi melalui yum adalah 1.2.1. Cara lain adalah dengan menggunakan adapter mysql_old pada DATABASE_ENGINE namun hal ini tidak dianjurkan.

cd /usr/local/src/
wget http://www.magnet-id.com/download/mysql/mysql-python/MySQL-python-1.2.2.tar.gz
tar xzvf MySQL-python-1.2.2.tar.gz
cd MySQL-python-1.2.2

python setup.py build
python setup.py install

service mysqld restart

Edit settings.py pada project anda;

su username
cd /home/username/procect/yourprojectname/

vi settings.py

Edit / modifikasi dan sesuaikan direktif berikut;

DATABASE_ENGINE = 'mysql'           # 'postgresql_psycopg2', 'postgresql', 'mysql', 'sqlite3' or 'ado_mssql'.
DATABASE_NAME = 'namadatabase'             # Or path to database file if using sqlite3.
DATABASE_USER = 'userdatabase'             # Not used with sqlite3.
DATABASE_PASSWORD = 'passworddatabase'         # Not used with sqlite3.
DATABASE_HOST = ''             # Set to empty string for localhost. Not used with sqlite3.
DATABASE_PORT = ''             # Set to empty string for default. Not used with sqlite3.

python manage.py syncdb

Apabila perintah tersebut dijalankan pertama kali maka anda akan diminta untuk membuat superuser fasilitas administrasi django, isi keterangan yang diminta dan ikuti langkah demi langkah setup.

Django Framework

Instalasi Django Framework http://www.djangoproject.com pada VPS anda sangat mudah untuk dilakukan, berikut adalah contoh instalasi pada VPS Magnet dengan CentOS 5.2 base install 64 bit melalui source (Official Version 0.96.2), kunjungi situs django untuk informasi rilis terbaru. Anda juga dapat melakukan instalasi rilis development melalui subversion, namun tidak dibahas pada artikel berikut.

Fasilitas komentar untuk artikel ini dimatikan, feedback dan error yang anda dapatkan saat menjalankan langkah-langkah yang diuraikan disini silahkan diutarakan melalui Forum Magnet http://forum.magnet-id.com/.

Instal paket yang dibutuhkan

yum install -y wget sudo

Tambahkan username dan berikan wewenang sudo untuk username tersebut, gantikan username dengan username yang ingin anda gunakan;

adduser username
passwd username

Berikan akses sudo ke username tersebut;

visudo

Tambahkan entry berikut;

username ALL=(ALL) ALL

Save dan Exit

:wq

Instalasi Django Framework

su username
cd /home/username/

wget http://www.magnet-id.com/download/framework/django/Django-0.96.2.tar.gz
tar xzfv Django-0.96.2.tar.gz
cd Django-0.96.2
sudo python setup.py install

Buat project pertama anda (misalkan projectsatu) di dalam direktori project;

mkdir /home/username/project/
cd /home/username/project/
django-admin.py startproject projectsatu

Di dalam direktori project anda akan terbuat direktori project satu yang berisi file-file berikut;

projectsatu/
__init__.py
__init__.pyc
manage.py
settings.py
settings.pyc
urls.py
urls.pyc

Development Server

Jalankan development web server django untuk melakukan pengetesan instalasi anda misalkan pada port 8080, gantikan keterangan IP Address dengan IP Address dedicated yang anda miliki.

python manage.py runserver 117.103.57.xxx:8080
Validating models...
0 errors found.

Django version 0.96.2, using settings 'projectsatu.settings'
Development server is running at http://117.103.57.xxx:8080/
Quit the server with CONTROL-C.

Buka IP Address dan port tersebut pada browser anda, apabila instalasi telah sukses dilakukan anda akan dissambut oleh halaman default development server django framework project anda.

Development Server Default Page Django Framework