Differences

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

--- project_management:redmine [2010/12/14 12:06] – aorth
+++ project_management:redmine [2020/01/30 12:52] (current) – removed aorth
@@ Line 1: / Line 1: @@
-====== Redmine Project Management ======
-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'' instead of ''ruby'':
-<code># vim /var/lib/gems/1.8/gems/passenger-2.2.14/bin/passenger-install-apache2-module</code>
-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 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 ===
-///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 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>