Info Solusi-Kami

e-Technology Documentation

 

 

Redmine adalah sebuah web aplikasi projek menejemen diatas Ruby on rails framework. Dalam tulisan ini akan di jelaskan penginstalan redmine dari source ataupun secara online pada ubuntu server 7.10. Jika anda mudah untuk mendapatkan koneksi internet, disarankan anda memakai fasilitas apt-get install yang ada pada ubuntu. Namun jika anda tidak mudah untuk mendapatkan koneksi internet karena berbagai hal dan keterbatasan, di dalam artikel ini akan dijelaskan secara detil penginstalan melalui source dan url dimana anda mendapatkan source.

 

Jika anda pemula dalam hal Linux/FreeBSD dan sebagainya, anda tidak perlu khawatir. Anda hanya perlu kemampuan dasar Linux seperti cara install, commad dasar pada Linux, dan configurasi apache saja. Selebihnya anda tinggal copy paste dari artikel ini.

Pertama-tama yang mesti anda lakukan adalah:

1. Banyak-banyak istigfar kepada Tuhan karena seberapa pandai dan lihai anda dalam hal Linux, hal tersebut tidak ada artinya tanpa izin dari Tuhan.

2. Banyak-banyak bersyukur karena kita diberikan kesempatan untuk tetap belajar dan terus memperbaiki diri kita menjadi hamba ALLAH yang baik dan sesuai kehendakNya

 

Tahapan dalam penginstallan redmine ini adalah :

1. Install ruby

2. Install rails

3. install redmine

4. install mongrels

5. configure port dan startup

6. Reboot

 

1. install ruby dan rails online

 

Login melaui root masukkan perintah

 

—————————————————————————————————————————

# sudo apt-get install libmysql-ruby mysql-server subversion apache2 ruby rubygems irb ri rdoc ruby1.8-dev build-essential phpmyadmin rake libapache2-mod-fastcgi

—————————————————————————————————————————

 

perintah diatas akan menginstall ruby dan juga apache dan mysql. Jika anda sudah menginstall apache dan mysql, apache dan mysql tidak perlu diinstall lagi.

 

Lalu install rails dan mongrels dengan memasukkan perintah

 

————————————————————————————

# sudo gem install rails mongrel mongrel_cluster daemons –include-dependencies

————————————————————————————

 

Jika perintah ini tidak berjalan karena masalah koneksi atau ftp source, lakukan penginstallan manual

 

2. Install ruby dan rails melalui source

 

$ Hal-yang perlu di download adalah

—————————————————————————————–

1. ruby 1.8.6 di ftp://ftp.ruby-lang.org/pub/ruby/1.8/ruby-1.8.6.tar.gz

2. rubygems 0.9.4 di http://rubyforge.org/frs/download.php/17190/rubygems-0.9.4.tgz

3. Rails 2.0.2 beserta librarynya :

# http://rubyforge.vm.bytemark.co.uk/gems/rake-0.8.1.gem

# http://rubyforge.vm.bytemark.co.uk/gems/activesupport-2.0.2.gem

# http://rubyforge.vm.bytemark.co.uk/gems/activerecord-2.0.2.gem

# http://rubyforge.vm.bytemark.co.uk/gems/actionpack-2.0.2.gem

# http://rubyforge.vm.bytemark.co.uk/gems/actionmailer-2.0.2.gem

# http://rubyforge.vm.bytemark.co.uk/gems/actionwebservice-1.2.6.gem

# http://rubyforge.vm.bytemark.co.uk/gems/rails-2.0.2.gem

# http://rubyforge.vm.bytemark.co.uk/gems/activeresource-2.0.2.gem

4. ZLib 1.2.3 di http://www.zlib.net/zlib-1.2.3.tar.gz

——————————————————————————————

 

INSTALL RUBY

a. extract ruby di direktori terserah dengan perintah tar -zxvf ruby-1.8.6.tar.gz

b. masuk ke direktori ruby dan jalan kan perintah

 

———————————

# sudo ./configure

# sudo make

# sudo make install

———————————

 

c. Lakukan hal yang sama dengan file zlib-1.2.3.tar.gz

d. setelah zlib terinstall masuk ke direktori ruby Jalankan perintah

 

——————————–

# extconf.rb,

# make

# make install

——————————–

 

e. Ekstract rubygems dengan perintah tar -zxvf <file rubygems>

f. Masuk ke direktori ekstrak rubygems dan jalankan perintah

 

——————————–

# ruby setup.rb

——————————–

 

INSTALL RAILS

a. masuk ke direktori Rails 2.0.2

b. install masing-masing file *.gem dengan perintah

 

——————————–

# gem install <nama file *.gem>

——————————–

 

c. Instalasi akan menunjukkan file yang lebih dulu harus di install

d. setelah semua gem terinstall jalankan perintah

 

——————————–

# gem list -local

——————————–

 

akan muncul daftar gem yang terinstall

 

Selamat, Ruby dan rails telah terinstall

 

3. Install Redmine

Sebelum menginstall redmine linux anda harus terinstal database server terlebih dahulu. Dalam tulisan ini dipakai mysql-server. Jika belum ada silahkan menginstall terlebih dahulu dengan perintah

 

—————————————————————-

#apt-get install mysql-server mysql-client libmysqlclient15-dev

—————————————————————-

 

download redmine dari http://www.redmine.org/wiki/redmine/Download

versi stable adalah versi 0.6.3

Setelah anda download letakkan file pada direktory /home

 

ekstrak redmine dengan perintah

 

——————————–

# tar -zxvf redmin-0.6.3.tar.gz

——————————–

 

ubah nama direktori redmine-0.6.3 dengan perintah

 

——————————–

# mv /redmine-0.6.3 /redmine

——————————–

 

Jalankan perintah mysql untuk membuat database redmine

 

———————————————-

# mysql

# create database redmine character set utf8;

# exit;

———————————————-

Masuk ke direktori redmine

 

———————————————-

# cd /home/redmine

———————————————-

 

Lakukan perintah untuk mengkopi database.example.yml ke database.yml pada direktori config

 

——————————————————-

# cp config/database.example.yml config database.yml

——————————————————-

 

Kemudian edit database.yml

 

——————————————

# sudo nano database.yml

——————————————

 

Ubah bagian production sesuai setting mysql anda

 

contoh:

———————————————–

production:

adapter: mysql #database anda

database: redmine #nama database redmine

host: localhost # nama host

username: bduser #username mysql

password: bdpasswd # password database

———————————————–

 

Masuk ke root redmine ( cd /home/redmine ) dan buat database struktur dengan perintah

 

———————————————–

# rake db:migrate RAILS_ENV=”production”

———————————————–

 

Masukkan data configurasi ke dalam database menggunakan perintah (masih pada root redmine)

 

——————————————————–

# rake redmine:load_default_data RAILS_ENV=”production”

——————————————————–

 

Jalankan WeBrick dengan perintah

 

————————————

# ruby script/server -e production

————————————

 

Dengan browser anda akses redmine dengan alamat

 

————————-

# http://localhost:3000

————————-

 

Untuk login

User : admin

paswd : admin

 

4. Install Mongrel

Mongrel digunakan sebagai http server untuk rubyonrails. Untuk menghubungkan antara apache dan mongrel memerlukan suatu paket yang disebut mongrel_cluster. Dalam artikel ini akan dijelaskan cara menginstall Mongres dan konfigurasi interface antara mongrels dan apache agar redmain dapat diakses dengan port 80.

Paket-paket yang perlu disiapkan untuk instalasi mongrels adalah

a. mongrel_cluster-1.0.5.gem

b. mongrel-1.1.3.gem

c. gem_plugin-0.2.3.gem

d. fastthread-1.0.1.gem

e. daemons-1.0.9.gem

f. cgi_multipart_eof_fix-2.5.0.gem

 

Install paket-paket mongrel tersebut dengan perintah dibawah pada direktori yang berisi paket-paket tersebut

 

——————————–

# gem install *.gem

——————————–

 

Lalu jalankan perintah dibawah ini untuk memberikan symbolic link pada /usr/bin

 

————————————————————————————-

# sudo ln -s /var/lib/gems/1.8/bin/mongrel_rails /usr/bin/mongrel_rails

# sudo ln -s /var/lib/gems/1.8/bin/rails /usr/bin/rails

# sudo ln -s /var/lib/gems/1.8/bin/mongrel_cluster_ctl /usr/bin/mongrel_cluster_ctl

————————————————————————————-

 

SETTING APACHE MONGREL

 

Pertama-tama setup mongrel untuk redmine:

1. Masuk kedalam direktori redmine

 

——————————————————————————————————————–

# cd /home/redmine

# sudo mongrel_rails cluster::configure -e production -p 8000 -N 3 -c /home/redmine –user www-data –group www-data

——————————————————————————————————————–

 

2. Start mongrel cluster

 

——————————————————-

# sudo mongrel_rails cluster::start

——————————————————-

 

3. Karena Apache harus dapat read dan write pada redmine maka perlu mengubah ownership dengan perintah

 

——————————————————-

# sudo chown -R www-data:www-data /home/redmine

——————————————————-

 

4. Edit file /home/redmine/public/.htaccess dengan perintah (optional)

 

——————————————————–

# cd /home/redmine/public

# sudo nano .htaccess

——————————————————–

 

Ganti isi file dengan

—————————————————————————————–

# General Apache options

AddHandler fastcgi-script .fcgi

AddHandler fcgid-script .fcgi

AddHandler cgi-script .cgi

Options +FollowSymLinks +ExecCGI

RewriteEngine On

RewriteRule ^$ index.html [QSA]

RewriteRule ^([^.]+)$ $1.html [QSA]

RewriteCond %{REQUEST_FILENAME} !-f

RewriteRule ^(.*)$ dispatch.fcgi [QSA,L]

ErrorDocument 500 “<h2>Application error</h2>Rails application failed to start properly”

——————————————————————————————-

 

5. Setting konfigurasi apache

masuk ke directory /etc/apache2 dan edit apache2.conf dengan perintah

 

———————————–

# cd /etc/apache2

# sudo nano apache.conf

———————————–

 

Ganti baris ke 181 yang berisi:

 

—————————————-

# Include module configuration:

Include /etc/apache2/mods-enabled/*.load

Include /etc/apache2/mods-enabled/*.conf

—————————————-

 

diganti dengan

——————————————-

# Include module configuration:

Include /etc/apache2/mods-available/*.load

Include /etc/apache2/mods-available/*.conf

——————————————-

 

Membuat site baru dengan cara:

masuk ke direktori /etc/apache2/sites-available dan edit file default

 

————————————————

# cd /etc/apache2/sites-available

# sudo nano default

————————————————

 

Ganti isi file dengan:

 

————————————————————

<VirtualHost *>

ServerAdmin email@example.com

ServerName redmine.example.com

ServerAlias example.com

RewriteEngine On

# Redirect all non-static requests to cluster

RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_FILENAME} !-f

RewriteRule ^/(.*)$ balancer://redminecluster%{REQUEST_URI} [P,QSA,L]

<Proxy balancer://redminecluster>

Order allow,deny

Allow from all

BalancerMember http://127.0.0.1:8000

BalancerMember http://127.0.0.1:8001

BalancerMember http://127.0.0.1:8002

</Proxy>

</VirtualHost>

 

Edit konfigurasi proxy pada apache

 

—————————————-

# cd /etc/apache2/mods-available

# sudo nano proxy.conf

—————————————-

 

Ganti script

—————————————

Order deny,allow

Deny from all

—————————————-

 

Menjadi

—————————————-

Order allow,deny

Allow from all

—————————————-

 

Restart Apache

————————————-

# sudo /etc/init.d/apache2 restart

————————————-

 

6. Menjalankan mongrel dari Start Up

Menghubungkan konfigurasi redmine mongrel cluster

 

—————————————————————————————

# sudo mkdir /etc/mongrel_cluster

# cd /etc/mongrel_cluster

# sudo ln -s /home/redmine/config/mongrel_cluster.yml /etc/mongrel_cluster/redmine.yml

—————————————————————————————

 

Cek apakah redmine.yml sudah ada dalam direktori /etc/mongrel_cluster dengan perintah ls

 

Mengkopi script mongrel startup ke init.d dengan perintah

 

————————————————————————

# cd /etc/init.d

# sudo cp /var/lib/gems/1.8/gems/mongrel_cluster-1.0.5/resources/mongrel_cluster /etc/init.d/

# sudo chmod +x /etc/init.d/mongrel_cluster

# sudo /usr/sbin/update-rc.d -f mongrel_cluster defaults

———————————————————————–

 

Restart ubuntu dengan perintah

 

———————–

# reboot

———————–

 

Setelah reboot dilakukan akses redmine pada browser dengan cara:

 

http://localhost

atau

http://<IP> # misalnya http://192.168.0.100

 

Selamat Redmain anda dapat diakses pada port 80…

Sekian selamat mencoba…

 

link terkait

http://www.redmine.org/wiki/redmine/HowTo_run_Redmine_with_a_Mongrel_cluster

http://mongrel.rubyforge.org/docs/mongrel_cluster.html

http://wiki.rubyonrails.org/rails/pages/RailsOnUbuntu

http://www.redmine.org/wiki/redmine/RedmineInstall

http://rubyforge.vm.bytemark.co.uk/gems/

 

JIka anda tidak menemukan source pada link diatas. Cobalah search nama source memakai google search engine.

 

Sekian..mohon maaf jika ada kesalahan