Redmine

h1. Redmine 1.1.0 + Apache + Passenger installation on Red Hat to a sub-URI

This guide line takes you through a new Redmine v. 1.1.0 installation on Red Hat Linux including the use of Passenger on Apache.  The following assumptions are made:

* You have a MySQL server up and running

* You have Apache Web Server up and running

h2. Install Ruby and required gems

# Get and install Ruby 

# Get and install Gems

# <code>gem install rails -v=2.3.5</code>

# <code>gem install -v=0.4.2 i18n</code>

# <code>gem install mysql</code>

# <code>gem install rake -v=0.8.3</code>

# <code>gem install rack -v=1.0.1</code>

# <code>gem install RedCloth</code>

# <code>gem install passenger</code>

# <code>passenger-install-apache2-module</code>

h2. Install Redmine

# Get and untar Redmine to some location 

# <code>export REDMINE_HOME=LOCATION_YOU_PLACED_REDMINE</code>

# <code>cd $REDMINE_HOME</code>

# <code>rake generate_session_store</code>

# <code>RAILS_ENV=production rake db:migrate</code>

# <code>RAILS_ENV=production rake redmine:load_default_data</code> (select "en" for language)

# <code>ruby script/server webrick -e production</code> (used to test that Redmine works on WEBrick, shutdown after test)

h2. Configure Apache to run Redmine

# <code>cd $REDMINE_HOME</code>

# <code>chown -R apache:apache files log tmp vendor</code>

# <code>cd $REDMINE_HOME/public</code>

# <code>mv dispatch.cgi.example dispatch.cgi</code>

# <code>mv dispatch.fcgi.example dispatch.fcgi</code>

# <code>mv dispatch.rb.example dispatch.rb</code>

# Edit dispatch.cgi and add the following lines

#* <code>#!/usr/local/bin/ruby</code>

#* <code>require /usr/local/lib/ruby/gems/1.8/gems/rails-2.3.5/lib/dispatcher.rb</code>

# Edit <code>$REDMINE_HOME/config/environment.rb</code> and add the following to the bottom: <code>Redmine::Utils::relative_url_root = "/redmine"</code>

# Edit <code>/etc/httpd/httpd.conf</code> and add the following lines

<pre>

   LoadModule passenger_module /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2/ext/apache2/mod_passenger.so

   PassengerRoot /usr/local/lib/ruby/gems/1.8/gems/passenger-3.0.2

   PassengerRuby /usr/local/bin/ruby

<VirtualHost *>

  ServerName YOUR_SERVER

  DocumentRoot YOUR_EXISTING_DOCUMENT_ROOT

  RailsEnv production

  RailsBaseURI /redmine

  PassengerDefaultUser apache

</VirtualHost>

</pre>

# <code>sudo ln -s $REDMINE_HOME/public YOUR_EXISTING_DOCUMENT_ROOT/redmine</code>

# Modify <code>$REDMINE_HOME/config/environment.rb</code> to add the following:

<pre>

# The below line is already in the file

Rails::Initializer.run do |config|

  # A bunch of stuff

  config.action_controller.relative_url_root = '/redmine'    # add this line here!

end

</pre>

h2. References

* "How to install Redmine on CentOS 5":http://www.redmine.org/projects/redmine/wiki/HowTo_install_Redmine_on_CentOS_5

* "HowTo_Install_Redmine_in_a_sub-URI":http://www.redmine.org/projects/redmine/wiki/HowTo_Install_Redmine_in_a_sub-URI

* "Rails Passenger":http://wiki.rubyonrails.org/deployment/apache-passenger