Differences

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

--- project_management:redmine [2010/09/02 18:27] – aorth
+++ 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
-====== Migrate Trac projects ======
-  * Reference: http://www.redmine.org/wiki/1/RedmineMigrate
-===== Install sqlite3-ruby =====
-My Trac 11.x databases were in sqlite3 format, so I needed the ''sqlite3-ruby'' gem:
-<code># gem install sqlite3-ruby</code>
-===== Migrate project =====
-From the Redmine directory:
-<code># rake redmine:migrate_from_trac RAILS_ENV="production"
-(in /opt/redmine-0.9.4)
-WARNING: a new project will be added to Redmine during this process.
-Are you sure you want to continue ? [y/N] y
-Trac directory []: /var/lib/trac/sampler
-Trac database adapter (sqlite, sqlite3, mysql, postgresql) [sqlite]: sqlite3
-Trac database encoding [UTF-8]:
-Target project identifier []: sampler
-Migrating components..
-Migrating milestones....
-Migrating custom fields
-Migrating tickets
-Migrating wiki........
-Components:      2/2
-Milestones:      4/4
-Tickets:         0/0
-Ticket files:    0/0
-Custom values:   0/0
-Wiki edits:      8/8
-Wiki files:      0/0</code>
-Make sure you don't use spaces in the project identifier; this is part of the URL path for the Redmine interface.
-====== Active Directory Authentication ======
-None of this seems to work...
-  * Reference: http://attic.ist.unomaha.edu/blogs/zac/2010/05/24/setting-up-redmine-or-php-with-ldapactive-directory-using-ldp/
-  * Reference: http://www.rhonabwy.com/wp/2009/12/24/debugging-active-directory-ldap-authentication-in-redmine/
-  * Reference: http://www.redmine.org/wiki/1/RedmineLDAP
-===== Patch =====
-http://www.redmine.org/issues/4283
-<code># cd /opt/redmine-0.9.4
-# patch -p1 < /home/aorth/src/lookup_LDAP_attributes_as_user.patch</code>
-====== 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:
-<code># cd /opt
-# tar cjf redmine_before_1.0.1.tar.bz2 redmine/
-# cd redmine
-# svn update
-# rake db:migrate RAILS_ENV=production
-# rake db:migrate_plugins RAILS_ENV=production
-# rake tmp:cache:clear
-# rake tmp:sessions:clear
-# apache2ctl graceful</code>