project_management:redmine
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
project_management:redmine [2010/06/09 15:15] – 172.26.14.218 | project_management:redmine [2011/02/22 05:39] – [Updating Redmine from SVN] aorth | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Redmine ====== | + | ====== Redmine |
- | Redmine is a bug tracking, source code and project management web application. Similar | + | Redmine is a bug tracking, source code and project management web application |
* Official install guide: http:// | * Official install guide: http:// | ||
Line 6: | Line 6: | ||
* Arch Linux wiki guide: http:// | * Arch Linux wiki guide: http:// | ||
- | ====== Install dependencies | + | ===== Install dependencies ===== |
- | ===== aptitude ===== | + | ==== apt-get |
- | < | + | < |
- | ===== Download ruby gems ===== | + | ==== Ruby gems ==== |
- | Problems I faced: | + | < |
- | * 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</ | ||
- | You SHOULD be able to '' | + | ===== Configure Redmine ===== |
- | < | + | |
- | 72.21.202.165 | + | |
- | Don't ask. I guess they are using the " | + | |
- | + | ||
- | < | + | |
- | $ wget http:// | + | |
- | $ wget http:// | + | |
- | $ wget http:// | + | |
- | $ wget http:// | + | |
- | $ wget http:// | + | |
- | + | ||
- | ===== Install gems ===== | + | |
- | Rake, for building gems: | + | |
- | < | + | |
- | Make sure you can execute the '' | + | |
- | < | + | |
- | # ln -s / | + | |
- | Continue installing gems: | + | |
- | < | + | |
- | # 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</ | + | |
- | + | ||
- | ====== Configure Redmine | + | |
Download and unzip the latest stable tarball: | Download and unzip the latest stable tarball: | ||
< | < | ||
$ tar zxf redmine-0.9.4.tar.gz</ | $ tar zxf redmine-0.9.4.tar.gz</ | ||
- | ===== Move redmine | + | ==== Move redmine ==== |
Move redmine somewhere universal, outside of your home folder. | Move redmine somewhere universal, outside of your home folder. | ||
Line 51: | Line 27: | ||
$ cd / | $ cd / | ||
- | ===== Configure the database | + | ==== Configure the database ==== |
We can either use MySQL or SQLite. | We can either use MySQL or SQLite. | ||
Line 59: | Line 35: | ||
| | ||
- | ===== Initialize the database | + | ==== Initialize the database ==== |
< | < | ||
$ rake rake generate_session_store | $ rake rake generate_session_store | ||
Line 65: | Line 41: | ||
$ RAILS_ENV=production rake redmine: | $ RAILS_ENV=production rake redmine: | ||
- | ===== Test the server | + | ==== 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: | Before we can use Redmine with Apache, we have to make sure the installation worked fine. Use the built-in webserver to test first: | ||
< | < | ||
Line 72: | Line 48: | ||
Navigate to http:// | Navigate to http:// | ||
- | ====== Configure Apache | + | ===== Configure Apache ===== |
- | ===== Install Phusion Passenger | + | ==== Install Phusion Passenger ==== |
Phusion Passenger (" | Phusion Passenger (" | ||
* Reference: http:// | * Reference: http:// | ||
- | * Also the guide on the [[http:// | + | * http:// |
- | ==== Install | + | === Enable |
- | < | + | < |
+ | $ sudo sh -c 'wget -q -O - http:// | ||
+ | $ sudo apt-get update</ | ||
- | ==== Install the Apache module | + | === Install the Apache module === |
- | Edit the invocation line of the passenger installer program to point to '' | + | < |
- | < | + | |
- | Run the installer: | + | |
- | < | + | |
- | ==== Configure Apache settings | + | === Configure Apache settings === |
- | Apache will serve Redmine via FastCGI | + | Apache will serve Redmine via Phusion Passenger, which doesn' |
- | ==== Configure mod_rail.conf ==== | + | === Configure redmine.conf === |
- | /// | + | |
- | < | + | |
- | PassengerRoot / | + | |
- | PassengerRuby / | + | |
- | + | ||
- | ==== Configure redmine.conf | + | |
/// | /// | ||
< | < | ||
Line 114: | Line 83: | ||
< | < | ||
- | ==== Fix dispatch.fcgi ==== | + | === Fix permissions === |
- | Rename it and make sure its executable: | + | |
- | < | + | |
- | $ chmod 755 public/ | + | |
- | + | ||
- | Edit the invocation line in the FastCGI script to make sure it points to your ruby version ('' | + | |
- | < | + | |
- | ... | + | |
- | require "/ | + | |
- | ...</ | + | |
- | + | ||
- | ==== Fix permissions | + | |
Change permissions so the web server can read/write important files/ | Change permissions so the web server can read/write important files/ | ||
< | < | ||
- | ==== Restart Apache | + | === Restart Apache === |
< | < | ||
- | ==== Test the install ==== | + | ===== Test the install |
http:// | http:// | ||
- | ====== Active Directory Authentication | + | ===== Migrate Trac projects ===== |
+ | * Reference: http:// | ||
+ | |||
+ | ==== Install sqlite3-ruby ==== | ||
+ | My Trac 11.x databases were in sqlite3 format, so I needed the '' | ||
+ | < | ||
+ | |||
+ | ==== Migrate project ==== | ||
+ | From the Redmine directory: | ||
+ | < | ||
+ | (in / | ||
+ | |||
+ | WARNING: a new project will be added to Redmine during this process. | ||
+ | Are you sure you want to continue ? [y/N] y | ||
+ | |||
+ | Trac directory []: / | ||
+ | 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: | ||
+ | Milestones: | ||
+ | Tickets: | ||
+ | Ticket files: | ||
+ | Custom values: | ||
+ | Wiki edits: | ||
+ | Wiki files: | ||
+ | |||
+ | 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... | None of this seems to work... | ||
Line 143: | Line 137: | ||
* Reference: http:// | * Reference: http:// | ||
- | ===== Patch ===== | + | ==== Patch ==== |
http:// | http:// | ||
< | < | ||
# patch -p1 < / | # patch -p1 < / | ||
+ | |||
+ | ===== Updating Redmine from SVN ===== | ||
+ | See the [[http:// | ||
+ | < | ||
+ | tar cjf redmine_before_1.0.1.tar.bz2 redmine/ | ||
+ | cd redmine | ||
+ | svn update | ||
+ | rake db:migrate RAILS_ENV=production | ||
+ | rake db: | ||
+ | rake tmp: | ||
+ | rake tmp: | ||
+ | apache2ctl graceful</ | ||
+ | |||
+ | ===== Change local administrator password manually ===== | ||
+ | < | ||
+ | # RAILS_ENV=production ruby1.8 script/ |