[Overview]
This entry will describe a basic installation and configuration of redmine, a flexible and cross-platform project management web application, on an archlinux system.

For the official installation guide, please refer this wiki page.

[Preparation]
1. Download the latest stable release of redmine (0.8.4) from rubyforge:

2. Install ruby and ruby on rails
(Notes: rails is optional since the redmine official release we download above already include the appropriate rails version (2.1.2) in its vendor directory)

3. Make sure rubygems and rake meet the version requirement of redmine:

[Database]
mysql is the recommended database of redmine, so here we will use mysql:

start mysql:

refer this wiki page for more information about mysql installation.

[Basic installation]
step 1: create redmine db with user “redmine”

step 2: configure redmine database settings for “production” environment

edit config/database.yml, make the production section looks like:

production:
adapter: mysql
database: redmine
host: localhost
username: redmine
password: password
encoding: utf8

step 3: create database structure and an administrator account

the default administrator account is:

username: admin
password: admin

step 4: insert default configuration data in database

according to the official wiki, this step is optional but highly recommended. It will load default roles, trackers, statuses, workflows and enumerations for our convenience.

step 5: test installation
start mongrel:

point your browser to navigate http://server-domain-or-ip:3000/ to see the redmine welcome page, use the default admin account above to login.

redmine home:

redmine administration setting:

[Deploy using phusion passenger (aka mod_rails)]
step 1: install passenger and its apache 2 module
install passenger:

install apache 2 module, please make sure g++, ruby, openssl and apache are installed before issue the command below:

follow the screen instructions and pay attention to the console output, some of them will be used later.

step 2: deploy and set up permissions

step 3: configure apache to use passenger
add one include at the end of httpd.conf:

create the httpd-rails.conf:

edit httpd-rails.conf, follow the former console output and add the passenger configuration there, below is my configuration, yours may be differ:

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

NameVirtualHost *:80

<VirtualHost *:80>
  ServerName SERVER-DOMAIN-OR-IP
  DocumentRoot /srv/http/rails/redmine-0.8.4/public
  RailsEnv production
  ErrorLog /var/log/httpd/rails_error_log
  CustomLog /var/log/httpd/rails_access_log common
</VirtualHost>

step 4: restart apache and test installation

navigate http://SERVER-DOMAIN-OR-IP/ to see if anything is broken.

[Optional components]
we use subversion for repository browsing:

and enable Gantt export to png image:

[Themes]
I like the Basecamp theme:

then the basecamp theme option is available in the drop-down list of “Theme” in the “General” tab under “Administration -> Settings”.

[SMTP]
to be continued…

[Plugins]
to be continued…

Related posts

• Install Ruby on Rails on Archlinux (0)
• ArchLinux, RVM, Ruby, Rails, Nginx, Passenger and You (3)
• SafeBoot双系统引导 (29)
• Archlinux下的时间时区设置 (15)
• ArchLinux 2009.02版本的改进 (3)