Ngadimin.Com - Tutorial Seputar Sistem Administrasi di Linux dan OS lainnya

Instalasi Redmine yang saya tulis ini, menggunakan versi redmine 0.8.x. Databasenya menggunakan MySQL dan untuk vcs nya saya gunakan subversion.

Yang dibutuhkan

Pertama, ruby on rails harus sudah terinstal di sistem. Caranya bisa Anda lihat di tulisan Instalasi Ruby on Rails di Ubuntu Hardy.

Yang kedua adalah apache dan mod_rails untuk menghosting aplikasi Redmine. Tahapan instalasi sudah saya buatkan ditulisan Instalasi Passenger (mod_rails) di Ubuntu Hardy.

Download Redmine

Pertama, kita ambil dulu sources instalasi redmine. Cek rilis terbaru di rubyforge.

wget http://rubyforge.org/frs/download.php/56909/redmine-0.8.4.tar.gz
tar zxvf redmine-0.8.4.tar.gz
sudo mv redmine-0.8.4 /opt/redmine
sudo chown -R www-data:www-data /opt/redmine

Sekarang kita sudah memiliki source instalasi, dan sudah kita instal di /opt/redmine. Mari kita lanjutkan dengan mengkonfigurasi database.

Konfigurasi Database

Pastikan MySQL sudah terinstal di sistem Anda. Jika belum, Anda bisa menginstalnya dari repositori.

sudo apt-get install mysql-server

Setelah itu, kita akan membuat database yang akan digunakan oleh redmine. Jalankan mysql client, masukkan password yang sudah diset saat menginstal mysql-server tadi.

mysql -u root -p

Lalu setelah muncul mysql prompt, ketikkan perintah di bawah ini.

create database redmine character set utf8;
create user 'redmine'@'localhost' identified by 'my_password';
grant all privileges on redmine.* to 'redmine'@'localhost';
flush privileges;

Langkah selanjutnya adalah membuat berkas konfigurasi. Sebelumnya kita salin terlebih dahulu berkas konfigurasi dari berkas contoh.

cd /opt/redmine/config
sudo cp database.yml.example database.yml

Lalu sunting berkas /opt/redmine/config/database.yml, cari bagian production, dan buat seperti di bawah ini (seperti yang sudah kita buat database dan user yang akan mengakses redmine, di tahapan sebelumnya).

1
2
3
4
5
6
7

production:
  adapter: mysql
  database: redmine
  host: 127.0.0.1
  username: redmine
  password: my_password
  encoding: utf8

Lalu buat struktur database, dengan cara menjalankan perintah di bawah ini. Perintah ini akan membuat tabel dan akun admin untuk redmine.

cd /opt/redmine/
rake db:migrate RAILS_ENV="production"

Dan sekarang kita muat konfigurasi default, caranya dengan menjalankan perintah berikut,

cd /opt/redmine/
rake redmine:load_default_data RAILS_ENV="production"

Test Instalasi

Tahapan pertama untuk instalasi Redmine sudah selesai. Mari kita test dengan menjalankan redmine via WEBrick.

cd /opt/redmine
sudo ruby script/server webrick -e production

Di layar akan muncul tulisan seperti berikut:

=> Booting WEBrick...
=> Rails 2.1.2 application started on http://0.0.0.0:3000
=> Ctrl-C to shutdown server; call with --help for options
[2009-08-14 06:47:30] INFO  WEBrick 1.3.1
[2009-08-14 06:47:30] INFO  ruby 1.8.6 (2007-09-24) [i486-linux]
[2009-08-14 06:47:30] INFO  WEBrick::HTTPServer#start: pid=5771 port=3000

Sekarang, coba Anda akses http://localhost:3000/login (atau http://ip.server.anda:3000/login). Seharusnya Anda sudah bisa melihat halaman login redmine.

Redmine Halaman Login

Untuk login dan password, defaultnya adalah admin/admin.

Untuk keluar dari WEBrick, Anda cukup tekan CTRL c saja. Pada saatnya nanti, kita akan menjalankan Redmine di apache dan mod_rails.

Menjalankan Redmine via Passenger (mod_rails)

Saya asumsikan Anda sudah menginstal passenger dan sudah berjalan dengan baik, seperti yang sudah saya tuliskan caranya di Instalasi Passenger (mod_rails) di Ubuntu Hardy.

Sekarang kita buat berkas konfigurasi VirtualHost untuk Redmine.

Buat berkas konfigurasi /etc/apache2/sites/available/redmine. Isinya kira-kira seperti di bawah ini.

1
2
3
4
5
6
7
8
9
10

<VirtualHost *>
    ServerAdmin webmaster@ngadimin.com
    ServerName redmine.ngadimin.com
 
    # ini lokasi instalasi redmine
    # jangan lupa path utk DocumentRoot adalah
    # ke direktori 'public'
    #
    DocumentRoot /opt/redmine/public
</VirtualHost>

Setelah itu jalankan perintah berikut:

sudo a2ensite redmine
sudo /etc/init.d/apache2 reload

Mungkin Anda juga perlu menjalankan perintah berikut, agar instalasi redmine Anda bisa dijalankan via Passenger.

sudo mv /opt/redmine/public/.htaccess /opt/redmine/public/.htaccess_off

Dan ada satu lagi yang harus Anda konfigurasi, yaitu berkas environment.rb, sunting berkas /opt/redmine/config/environment.rb, cari baris berikut dan hapus tanda pagar (#) di depannya.

1

ENV['RAILS_ENV'] ||= 'production'

Anda perlu merestart kembali service apache2, agar konfigurasi yang baru saja kita ubah bisa langsung diterapkan.

sudo /etc/init.d/apache2 restart

Dan instalasi Redmine bisa Anda akses via http://redmine.ngadimin.com/ (atau via hostname yang Anda set).

Mengkonfigurasi Email

Jangan lupa untuk mengkonfigurasi email untuk Redmine. Caranya Anda salin terlebih dahulu berkas konfigurasi contoh.

cd /opt/redmine/config
sudo cp email.yml.example email.yml

Buka berkas konfigurasi tadi, lalu cari bagian production. Dan set menjadi seperti dibawah ini. Contoh menggunakan domain ngadimin.com.

1
2
3
4
5
6
7

production:
  delivery_method: :smtp
  smtp_settings:
    address: smtp.ngadimin.com
    port: 25
    domain: ngadimin.com
    authentication: :none

Atau jika SMTP yang Anda gunakan membutuhkan autentikasi, set menjadi seperti di bawah ini.

1
2
3
4
5
6
7
8
9

production:
  delivery_method: :smtp
  smtp_settings:
    address: smtp.ngadimin.com
    port: 25
    domain: ngadimin.com
    authentication: :login
    user_name: redmine@ngadimin.com
    password: redmine

Silakan Anda merujuk ke dokumentasi Redmine untuk penjelasan yang lebih lengkap.

Mengkonfigurasi Subversion

Instal terlebih dahulu paket yang diperlukan.

sudo apt-get install subversion libapache2-svn libapache-dbi-perl \
    libapache2-mod-perl2 libdbd-mysql-perl libdigest-sha1-perl

Selanjutnya aktifkan modul-modul apache tadi (seharusnya tahapan ini sudah dijalankan pada saat instalasi, tapi ini untuk lebih memastikan saja).

sudo a2enmod dav
sudo a2enmod dav_svn
sudo a2enmod perl

Salin berkas Redmine.pm ke instalasi pustaka perl.

sudo cp /opt/redmine/extra/svn/Redmine.pm /usr/lib/perl5/Apache/

Lalu buat direktori /var/svn untuk repositori subversion kita.

sudo mkdir /var/svn
sudo chown www-data:www-data /var/svn

Sekarang kita buat konfigurasi VirtualHost di apache, untuk repositori svn kita.

Buat berkas baru di /etc/apache2/sites/available/svn

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

<VirtualHost *>
    ServerAdmin webmaster@ngadimin.com
    ServerName svn.ngadimin.com
 
    PerlLoadModule Apache::Redmine
 
    <Location />
        DAV svn
        SVNParentPath "/var/svn"
 
        AuthType Basic
        AuthName redmine
        Require valid-user
 
        PerlAccessHandler Apache::Authn::Redmine::access_handler
        PerlAuthenHandler Apache::Authn::Redmine::authen_handler
 
        RedmineDSN "DBI:mysql:database=redmine;host=localhost"
        RedmineDbUser "redmine"
        RedmineDbPass "my_password"
    </Location>
</VirtualHost>

Setelah itu jalankan

sudo a2ensite svn
sudo /etc/init.d/apache2 reload

Instalasi subversion sudah siap, tapi kita belum bisa mencobanya. Untuk mencobanya, kita harus membuat dulu proyek baru di Redmine.

Membuat Proyek Baru

Untuk menguji instalasi Redmine, kita harus membuat proyek baru. Caranya, buka halaman login redmine lalu buat proyek baru.

http://redmine.ngadimin.com/login    --> halaman login
http://redmine.ngadimin.com/projects/add    --> halaman untuk menambahkan proyek baru

Membuat Proyek di Redmine

Setelah proyek dibuat, sekarang masuk ke menu Administration -> Settings, lalu masuk ke tab Repositories. Anda centang bagian “Enable WS for repository management“.

Enable WS for repository management

Setelah itu, Anda jalankan skrip berikut, untuk membuat repositori svn untuk proyek yang baru kita buat.

sudo ruby reposman.rb --redmine http://redmine.ngadimin.com --svn-dir /var/svn \
    --owner www-data --url http://svn.ngadimin.com/ --verbose

Dan Anda akan melihat tampilan seperti berikut.

querying Redmine for projects...
retrieved 1 projects
treating project Proyek Pertama
        repository /var/svn/proyek-pertama registered in Redmine with url http://svn.ngadimin.com/proyek-pertama
        repository /var/svn/proyek-pertama created

Seperti terlihat di atas, repositori dibuat di /var/svn/proyek-pertama, dan otomatis diregister ke redmine.

Rangkuman

Walaupun tulisannya panjang, tapi mudah-mudahan cukup jelas dan mencakup banyak aspek terpenting dalam proses instalasi Redmine.

Seperti biasa, jika ada pertanyaan silakan tinggalkan di bagian komentar.