Differences

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

--- project_management:redmine [2010/06/09 12:08] – 172.26.14.218
+++ project_management:redmine [2020/01/30 12:52] (current) – removed aorth
@@ Line 1: / Line 1: @@
-====== Redmine ======
-Redmine is a bug tracking, source code and project management web application.  Similar to [[project_management:trac|Trac]].
-  * Official install guide: http://www.redmine.org/wiki/redmine/RedmineInstall
-  * Unofficial install guide: http://library.linode.com/development/project-management/redmine/ubuntu-9.10
-  * Arch Linux wiki guide: http://wiki.archlinux.org/index.php/Redmine_setup
-====== Install dependencies ======
-===== aptitude =====
-<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>
-===== Download ruby gems =====
-Problems I faced:
-  * DNS is screwed up for rubyforge.org and rubygems.org.
-  * rubyforge.org has old versions of some gems (rails!)
-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
-.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 ======
-Download and unzip the latest stable tarball:
-<code>$ wget http://rubyforge.org/frs/download.php/70486/redmine-0.9.4.tar.gz
-$ tar zxf redmine-0.9.4.tar.gz</code>
-===== Move redmine =====
-Move redmine somewhere universal, outside of your home folder.  We will configure Apache to serve redmine from this location:
-<code>$ sudo mv redmine-0.9.4 /opt/
-$ cd /opt/redmine-0.9.4</code>
-===== Configure the database =====
-We can either use MySQL or SQLite.  SQLite has less overhead, and I'm not sure if it's any slower so we'll use that.
-Edit //config/database.yml//:
-<file> production:
-   adapter: sqlite3
-   dbfile: db/redmine.db</file>
-===== Initialize the database =====
-<code>$ chmod 600 config/database.yml
-$ rake rake generate_session_store
-$ RAILS_ENV=production rake db:migrate
-$ RAILS_ENV=production rake redmine:load_default_data</code>
-===== Test the server =====
-Before we can use Redmine with Apache, we have to make sure the installation worked fine.  Use the built-in webserver to test first:
-<code>$ script/server -e production</code>
-If you get an error about not finding ruby, make sure the ruby version in the ''script/server'' script is correct.
-Navigate to http://ip:3000 to see Redmine working.  The default username and password are "admin"
-====== Configure Apache ======
-===== Install Phusion Passenger =====
-Phusion Passenger ("mod_rails") is an Apache module which allows Apache to run ruby code (like mod_perl, mod_php, etc).
-  * 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]]
-==== Install the gem ====
-<code># gem install passenger</code>
-==== Install the Apache module ====
-Edit the invocation line of the passenger installer program to point to ''ruby1.8'':
-<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 ====
-Apache will serve Redmine via FastCGI using the included ''dispatch.fcgi'' script.  This is much faster than using Webrick or regular 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 ====
-///etc/apache2/conf.d/redmine.conf//:
-<file>RailsBaseURI /redmine
-RailsEnv production
-<Directory "/var/www/redmine">
-        AllowOverride all
-        Options -MultiViews
-        #Options Indexes ExecCGI FollowSymLinks
-        Order allow,deny
-        Allow from all
-</Directory></file>
-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>
-==== 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 ====
-Change permissions so the web server can read/write important files/folders:
-<code>$ chown -R www-data:www-data /opt/redmine-0.9.4</code>
-==== Restart Apache ====
-<code># apache2ctl graceful</code>
-==== Test the install ====
-http://ip/redmine