Redmine

Assuming¶

• Apache is up and running
• Apache has previously been used and works quite well
• MySQL is up and running
• MySQL has previously been used and works quite well
• Your are logged as root
• The next steps are done successively without errors

Get Ruby¶

cd ~/Downloads # YOUR FOLDER OF CHOICE
ftp ftp.ruby-lang.org
cd /pub/ruby
get ruby-1.8.7.pXXX.tar.gz
tar zxvf ruby-1.8.7.pXXX.tar.gz ruby-1.8.7.pXXX
cd ruby-1.8.7.pXXX
./configure
make
make install
ruby -v
which ruby
cd ..

Get Gems¶

wget http://production.cf.rubygems.org/rubygems/rubygems-1.x.tgz
tar zxvf rubygems-1.x.tgz rubygems-1.x
cd rubygems-1.x
ruby setup.rb
gem -v
which gem
cd ..

Install Passenger¶

gem install passenger
passenger-install-apache2-module

Restart Apache¶

Download Redmine¶

wget http://rubyforge.org/frs/download.php/73692/redmine-1.x.tar.gz # GET LATEST VERSION ON RUBYFORGE
tar zxvf redmine-1.x.tar.gz redmine-1.x

Copy the folder to its HTTP document root folder¶

cp redmine-1.x /var/www/redmine-1.x

Configure Apache to host the documents¶

Install Bundler¶

gem install Bundler

Add the Bundler Boot and preinitializer code¶

(For more info go to the Bundler site )

Create the Gemfile and register these gems in it¶

• "rake", "0.8.3"
• "rack", "1.0.1"
• "i18n", "0.3.7"
• "rubytree", "0.5.2", :require => "tree"
• "RedCloth", "~>4.2.3", :require => "redcloth" # for CodeRay
• "mysql"

bundle install

Create the Redmine MySQL database¶

Configure database.yml (rename database.yml.example)¶

Set the production environment (optional)¶

Uncomment the following line:

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

Generate the session store¶

RAILS_ENV=production bundle exec rake generate_session_store

Migrate the database models¶

RAILS_ENV=production bundle exec rake db:migrate

Load default data (optional)¶

RAILS_ENV=production bundle exec rake redmine:load_default_data

Follow instructions.

Rename dispatch CGI files¶

mv dispatch.cgi.example dispatch.cgi
mv dispatch.fcgi.example dispatch.fcgi
mv dispatch.rb.example dispatch.rb

Edit .htaccess file for CGI dispatch configuration¶

Chown and Chmod files for read/write access for the Apache user¶

cd ..
chown -R apache:apache redmine-1.x
chmod -R 755 redmine-1.x

Redmine should be fully installed now and fully usable¶

Enjoy!