Install Procedure

• Install packages
  

  yum install ruby-devel gcc-c++ openssl-devel httpd httpd-devel mysql-server  mysql-devel make ruby-rdoc libcurl-devel rubygem-rake

• Rubygems. Version 1.6.2 is the current sweet spot. Using the latest version will result to “depreciated errors in apache error logs”. Using an older version will prevent you from installing bundle
  

  cd /tmp/
  wget http://production.cf.rubygems.org/rubygems/rubygems-1.6.2.tgz
  tar xvfz rubygems-1.6.2.tgz
  cd rubygems-1.6.2
  ruby setup.rb

• Passenger
  

  gem install passenger
  passenger-install-apache2-module

• Load the passenger apache module. Add the following config in /etc/httpd/conf/httpd.conf
  

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

• Setup apache vhost
  

  cat <<'EOF' > /etc/httpd/conf.d/redmine.conf
  <VirtualHost *:80>
   ServerName redmine.local
   DocumentRoot /var/www/redmine/public/
   
   <Directory "/var/www/redmine/public/">
    Options Indexes ExecCGI FollowSymLinks
    AllowOverride all
    Order allow,deny
    Allow from all
   </Directory>
  </VirtualHost>
  EOF
  

  Note that redmine.local is a local domain and is a manual entry in my workstation's /etc/hosts file. This is done for testing purposes only. For production systems, this may very well be a subdomain under you company's domain name e.g. redmine.acme.com

• Download and extract redmine
  

  cd /tmp
  wget http://rubyforge.org/frs/download.php/75910/redmine-1.3.2.tar.gz
  tar xvfz redmine-1.3.2.tar.gz
  mkdir /var/www/redmine
  cp -a redmine-1.3.2/* /var/www/redmine
   
  chown -R apache.apache /var/www/redmine && chmod -R 755 /var/www/redmine
    

  touch /var/www/redmine/log/production.log

  chown root.apache /var/www/redmine/log/production.log
  chmod 664 /var/www/redmine/log/production.log

• Prep Gemfile dependency
  

  cat <<EOF> /var/www/redmine/Gemfile
  source "http://rubygems.org" 
  gem "rake", "0.8.3" 
  gem "rack", "1.1.0" 
  gem "i18n", "0.4.2" 
  gem "rubytree", "0.5.2", :require => "tree" 
  gem "RedCloth", "~>4.2.3", :require => "redcloth" # for CodeRay
  gem "mysql" 
  gem "coderay", "~>0.9.7" 
  EOF
  

• Bundle
  

  gem install bundler
  cd /var/www/redmine/
  bundle install

• Move CGI files
  

  cd /var/www/redmine/public/
  mv dispatch.cgi.example dispatch.cgi
  mv dispatch.fcgi.example dispatch.fcgi
  mv dispatch.rb.example dispatch.rb
  mv htaccess.fcgi.example .htaccess

• Set rails to production environment in /var/www/redmine/config/environment.rb
  

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

• Setup MySQL DB
  

  service mysqld start
  chkconfig mysqld on
  /usr/bin/mysql_secure_installation
  mysql -uroot -p -e 'create database redmine character set utf8; grant all on redmine.* to redmine@localhost identified by "my_passwd";flush privileges';

• Setup redmine database connection
  

  mv /var/www/redmine/config/database.yml.example /var/www/redmine/config/database.yml
  vi /var/www/redmine/config/database.yml
   
  # In the production section, update username, password and other parameters accordingly like so:
   
  production:
    adapter: mysql
    database: redmine
    host: localhost
    username: redmine
    password: my_passwd
    encoding: utf8

• Create session store
  

  cd /var/www/redmine
  RAILS_ENV=production bundle exec rake generate_session_store

• Migrate database models
  

  RAILS_ENV=production bundle exec rake db:migrate

• Load MySQL database schema and default data
  

  RAILS_ENV=production bundle exec rake redmine:load_default_data

• and finally, start Apache
  

  service httpd start
  chkconfig httpd on 

• you may now open and point your browser to http://redmine.local and login as admin/admin