Redmine is a fantastic Issue Tracking (defects and enhancements) web application written in Ruby on Rails. I’ve been using it for quite a while, and it’s a good looking, simple but powerful defect management tool with a bunch of value-add features like document repositories, wikis, roadmap and time tracking.
Rails apps can be a bit mysterious to deploy on Windows server’s however, so here is a 1 minute guide to installing Redmine on Ruby on Rails on Windows.
You will need an Internet connected Windows PC or server to get started. If you don’t have an Internet-enabled PC, you can do the install on an Internet connected PC and move the Ruby folder tree to your target machine, but I’ll assume you live in the 21st century and do have Internet connectivity.
- Download version 1.8 of Ruby – the link is to the “all-in-one” installer for Windows. You need version 1.8, not 1.9 as Redmine only works on 1.8 right now.
- Set up so Ruby’s “bin” folder is in your system or command prompt path. You should be able to type “ruby” at the command prompt and not get any “file not found” errors.
- Create yourself some sort of “Ruby apps” folder and open a command prompt at that location, e.g. C:\Ruby\Apps or something
- At the command prompt: “gem install rails“
- At the command prompt: “gem install mongrel“
- Download the latest stable version of Redmine and unzip into a subfolder of your Ruby apps dir (e.g. C:\Ruby\Apps\Redmine)
- Configure the database.yml for Redmine to point to a database for your Redmine instance to use (I’ll leave that up to you)
- In the Redmine folder, at the command prompt: “rake db:migrate“
- If you’re using Redmine v0.8.7 or above, at the command prompt: “rake generate_session_store”
- Test your Redmine installation is working, at the command prompt: “mongrel_rails start“, then hit http://localhost:%5Bport%5D/ in your browser where [port] is the port Mongrel started with. Kill the server with Ctrl+C once you’ve verified Redmine is working.
- At the command prompt: “gem install win32-service“
- At the command prompt: “gem install mongrel_service“
- Install Redmine as a Windows service, at the command prompt: “mongrel_rails service::install -N Redmine -c [your redmine folder] -p [portno] -e production“, replacing [your redmine folder] with the full path to the Redmine folder in the filesystem, and the [portno] being the port you’d like redmine to server on, e.g. 80 for standard http port 80.
If at any time you wish to remove the Redmine windows service (uninstall), you can enter “mongrel_rails service::remove -N Redmine” at the command prompt to remove it.
If you get an error at any one of the steps above, well, you’re going to have to go hit up Google for some solutions. But from a fresh install the above should work just fine