ILRI Research Computing

User Tools

Site Tools

You are here: start » project_management » redmine
project_management:redmine

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Last revisionBoth sides next revision
project_management:redmine [2010/10/19 17:59] – aorthproject_management:redmine [2011/02/22 05:39] – [Updating Redmine from SVN] aorth
Line 7: Line 7:
  
 ===== Install dependencies ===== ===== Install dependencies =====
-==== aptitude ==== +==== apt-get ==== 
-<code># aptitude install build-essential rake ruby1.8 ruby1.8-dev irb1.8 rdoc1.8 zlib1g-dev libopenssl-ruby1.8 libzlib-ruby libssl-dev rubygems1.8</code>+<code>$ sudo apt-get install build-essential ruby rubygems libopenssl-ruby libsqlite3-dev</code>
  
-==== Download ruby gems ==== +==== Ruby gems ==== 
-Problems I faced: +<code>$ sudo gem install rails -v=2.3.5 
-  * DNS is screwed up for rubyforge.org and rubygems.org. +$ sudo gem install sqlite3 
-  * rubyforge.org has old versions of some gems (rails!) +$ sudo gem install fastthread 
- +$ sudo gem install -v=0.4.2 i18n</code>
-You SHOULD be able to ''gem install'' the modules, but I downloaded them all manually and installed manually.  It turns out it was a DNS issue, and I had to add some entries to the machine's ///etc/hosts// file: +
-<file>216.137.39.169  production.cf.rubygems.org d2chzxaqi4y7f8.cloudfront.net +
-72.21.202.165   production.s3.rubygems.org</file> +
-Don't ask.  I guess they are using the "cloud" and Amazon to host the files.  I found these IPs from doing DNS queries outside ILRI. +
- +
-<code>$ wget http://rubygems.org/downloads/rack-1.0.1.gem +
-$ wget http://rubygems.org/downloads/rails-2.3.5.gem +
-$ wget http://rubygems.org/downloads/mysql-2.8.1.gem +
-$ wget http://rubygems.org/downloads/sqlite3-ruby-1.3.0.gem +
-$ wget http://rubygems.org/downloads/rake-0.8.7.gem +
-$ wget http://rubygems.org/downloads/fastthread-1.0.7.gem</code> +
- +
-==== Install gems ==== +
-Rake, for building gems: +
-<code># gem install rake-0.8.3.gem</code> +
-Make sure you can execute the ''rake'' binary: +
-<code># cd /usr/local/bin/ +
-# ln -s /var/lib/gems/1.8/bin/rake</code> +
-Continue installing gems: +
-<code># gem install rack-1.0.1.gem +
-# gem install fastthread-1.0.7.gem +
-# gem install mysql-2.8.1.gem +
-# gem install sqlite3-ruby-1.3.0.gem +
-# gem install rails-2.3.5.gem</code>+
  
 ===== Configure Redmine ===== ===== Configure Redmine =====
Line 78: Line 54:
  
   * Reference: http://www.modrails.com/install.html   * Reference: http://www.modrails.com/install.html
-  * Also the guide on the [[http://wiki.archlinux.org/index.php/Redmine_setup#Apache_w.2F_Phusion_Passenger|Arch Linux wiki]]+  * http://wiki.brightbox.co.uk/docs:phusion-passenger
  
-=== Install the gem === +=== Enable the repository === 
-<code># gem install passenger</code>+<code>$ sudo sh -c 'echo "deb http://apt.brightbox.net lucid main" > /etc/apt/sources.list.d/phusion_passenger.list' 
 +$ sudo sh -c 'wget -q -O - http://apt.brightbox.net/release.asc | apt-key add -' 
 +$ sudo apt-get update</code>
  
 === Install the Apache module === === Install the Apache module ===
-Edit the invocation line of the passenger installer program to point to ''ruby1.8'': +<code>$ sudo apt-get install libapache2-mod-passenger</code>
-<file>#!/usr/bin/env ruby1.8</file> +
-Run the installer: +
-<code># /var/lib/gems/1.8/gems/passenger-2.2.14/bin/passenger-install-apache2-module</code>+
  
 === Configure Apache settings === === Configure Apache settings ===
-Apache will serve Redmine via FastCGI using the included ''dispatch.fcgi'' script.  This is much faster than using Webrick or regular CGI. +Apache will serve Redmine via Phusion Passenger, which doesn't rely on CGI or FastCGI!  Make sure the .htaccess in ''redmine/public'' is not enabled or it might try to serve Redmine via ''dispatch.cgi''.
- +
-=== Configure mod_rail.conf === +
-///etc/apache2/conf.d/mod_rails.conf//: +
-<file>LoadModule passenger_module /var/lib/gems/1.8/gems/passenger-2.2.14/ext/apache2/mod_passenger.so +
-PassengerRoot /var/lib/gems/1.8/gems/passenger-2.2.14 +
-PassengerRuby /usr/bin/ruby1.8</file>+
  
 === Configure redmine.conf === === Configure redmine.conf ===
Line 113: Line 82:
 Link the Redmine installation to the web document root; make sure to use the same name as in your Apache configuration: Link the Redmine installation to the web document root; make sure to use the same name as in your Apache configuration:
 <code># ln -s /opt/redmine-0.9.4/public/ /var/www/redmine</code> <code># ln -s /opt/redmine-0.9.4/public/ /var/www/redmine</code>
- 
-=== Fix dispatch.fcgi === 
-Rename it and make sure its executable: 
-<code>$ mv public/dispatch.fcgi.example public/dispatch.fcgi 
-$ chmod 755 public/dispatch.fcgi</code> 
- 
-Edit the invocation line in the FastCGI script to make sure it points to your ruby version (''ruby1.8''), and that the ''dispatcher'' line is correct: 
-<file>#!/usr/bin/env ruby1.8 
-... 
-require "/var/lib/gems/1.8/gems/rails-2.3.5/lib/dispatcher.rb" 
-...</file> 
  
 === Fix permissions === === Fix permissions ===
Line 132: Line 90:
 <code># apache2ctl graceful</code> <code># apache2ctl graceful</code>
  
-=== Test the install ===+===== Test the install =====
  
 http://ip/redmine http://ip/redmine
Line 186: Line 144:
  
 ===== Updating Redmine from SVN ===== ===== Updating Redmine from SVN =====
-See the [[http://www.redmine.org/wiki/redmine/RedmineUpgrade#Option-2-Upgrading-from-a-SVN-checkout|the official instructions]] on upgrading via SVN.  Also done below on a real instance, 1.0.0 -> 1.0.1: +See the [[http://www.redmine.org/wiki/redmine/RedmineUpgrade#Option-2-Upgrading-from-a-SVN-checkout|the official instructions]] on upgrading via SVN.  Also done below as root on a real instance, 1.0.0 -> 1.0.1: 
-<code># cd /opt +<code>cd /opt 
-# tar cjf redmine_before_1.0.1.tar.bz2 redmine/ +tar cjf redmine_before_1.0.1.tar.bz2 redmine/ 
-# cd redmine +cd redmine 
-# svn update +svn update 
-# rake db:migrate RAILS_ENV=production +rake db:migrate RAILS_ENV=production 
-# rake db:migrate_plugins RAILS_ENV=production +rake db:migrate_plugins RAILS_ENV=production 
-# rake tmp:cache:clear +rake tmp:cache:clear 
-# rake tmp:sessions:clear +rake tmp:sessions:clear 
-# apache2ctl graceful</code>+apache2ctl graceful</code> 
 + 
 +===== Change local administrator password manually ===== 
 +<code># cd /opt/redmine 
 +# RAILS_ENV=production ruby1.8 script/runner 'user = User.find(:first, :conditions => {:admin => true}) ; user.password, user.password_confirmation = "my_password"; user.save!'</code>