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

Install Ruby and required gems¶

1. Get and install Ruby
2. Get and install Gems
3. gem install rails -v=2.3.5
4. gem install -v=0.4.2 i18n
5. gem install mysql
6. gem install rake -v=0.8.3
7. gem install rack -v=1.0.1
8. gem install RedCloth
9. gem install passenger
10. passenger-install-apache2-module

Install Redmine¶

1. Get and untar Redmine to some location
2. export REDMINE_HOME=LOCATION_YOU_PLACED_REDMINE
3. cd $REDMINE_HOME
4. rake generate_session_store
5. RAILS_ENV=production rake db:migrate
6. RAILS_ENV=production rake redmine:load_default_data (select "en" for language)
7. ruby script/server webrick -e production (used to test that Redmine works on WEBrick, shutdown after test)

Configure Apache to run Redmine¶

1. cd $REDMINE_HOME
2. chown -R apache:apache files log tmp vendor
3. cd $REDMINE_HOME/public
4. mv dispatch.cgi.example dispatch.cgi
5. mv dispatch.fcgi.example dispatch.fcgi
6. mv dispatch.rb.example dispatch.rb
7. Edit dispatch.cgi and add the following lines
   • #!/usr/local/bin/ruby
   • require /usr/local/lib/ruby/gems/1.8/gems/rails-2.3.5/lib/dispatcher.rb
8. Edit $REDMINE_HOME/config/environment.rb and add the following to the bottom: Redmine::Utils::relative_url_root = "/redmine"
9. Edit /etc/httpd/httpd.conf and add the following lines
   

      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
   </VirtualHost>
   

10. sudo ln -s $REDMINE_HOME/public YOUR_EXISTING_DOCUMENT_ROOT/redmine
11. Modify $REDMINE_HOME/config/environment.rb to add the following:
    

    # 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
    

References¶

• How to install Redmine on CentOS 5
• HowTo_Install_Redmine_in_a_sub-URI
• Rails Passenger