LogikDevelopment

Did you guys ever hear about Redmine? It is an open source project management web application written using Ruby on Rails framework. I already used it in the past and it is quite powerful!

I wanted to install the last version (1.1.3) on my HostMonster account. I would lie if I say that it has been easy… However, after a few try and some help from the HostMonster support, I finally got it to work. 🙂

These instructions are basically a copy of the ones I found on GetTaskDone but updated with additional steps (in red):

1. Create MySQL Database and Username
   Login to CPanel and click on MySQL Database Wizard, it will prompt you for database name, then ask you to make a user, make sure you GRANT ALL privileges. Remember these database details, we will use them later.
2. Create a Sub-Domain
   For the purposes of this tutorial, name it redmine, point this sub domain to ~/public_html/redmine.
   Do NOT copy any files into this directory, we will be deleting it later.
3. Make sure you have the right version of Rails installed
   In case it is different from what you need you can install a specific Rails version on your machine by running:

   %prompt> gem install rails -v=2.3.5
   

4. Create RoR directory
   It is not recommended that you put your RoR apps within the ~/public_html directory, as users would be able to see the rb files. So we are going to create a rails directory.

   %prompt> cd ~
   %prompt> mkdir rails
   

5. Create Rails App
   You create a rails app on HostMonster just like you would on your system, by using the rails command. We are creating the rails project inside of the rails directory.

   %prompt> cd rails
   %prompt> rails -D redmine
   

   We need -D to let rails know that we want custom dispatch.rb, dispatch.cgi and dispatch.fcgi files for later steps.

6. Create a Sym-Link for Sub-Domain
   Since the HostMonster interface won’t let you select a directory outside of public_html, we are going to create a symbolic link from the ~/public_html/redmine folder to ~/rails/redmine. To do this we will be deleting the ~/public_html/redmine directory. The symbolic link will recreate it.

   %prompt> cd ~/public_html
   %prompt> rm -R redmine
   %prompt> ln -s ~/rails/redmine/public redmine
   

   Please note the space between ~/rails/redmine/public and redmine This command says create a new folder named redmine that points to ~/rails/redmine/public

7. Do a Smoke-Test
   Goto subdomain.yourdomain.com, you should see the default rails welcome page. This is fine, this is what you should see right now.
8. Prepare Redmine
   Download the latest final release of Redmine (it’s 1.1.3 now). Extract this to your desktop, you should now have a folder name redmine on your desktop. Login to your CPanel and goto File Manager. You’ll want to navigate to ~/rails/redmine/public, you’ll want to download the following files and put them in your local copy of redmine. Which should be ~/Desktop/redmine/public. Download dispatch.rb, dispatch.cgi and dispatch.fcgi.
   Now edit your database.yml file with the database, username and password you created in step one. You only have to change those three values for production and development configurations. To do so copy config/database.yml.example into config/database.yml and edit the latter. Comment out all the rest lines.
   Now inside of your local redmine folder select all the files and folders and right click and select ‘Compress all the items…’. What we are doing is uploading this archive, I seem to have problems every time I try to upload redmine file by file.
9. Upload Redmine
   If you don’t have File Manager open still then login to CPanel and open it again. Navigate to your ~/rails/redmine folder and click the check boxes on all items and click delete. Now, upload your archive. Once it’s done uploading click on the archive in File Manager and hit extract.
10. Finish install
    Now ssh into your server, you’re going to want to chmod 755 your ~/rails/redmine/public folder.

    %prompt> cd ~/rails/redmine
    %prompt> chmod 755 public
    

    Next, you must create a custom .htaccess file for Apache to handle this directory properly. First remove any .htaccess file that may already be in the ~/rails/redmine/public directory.

    %prompt> cd public
    %prompt> rm .htaccess
    

    Download file from here: http://www.gettaskdone.com/redmine-htaccess/htaccess.txt into ~/rails/redmine/public directory and save it as .htaccess.
    Best way to do this is by typing following set of commands:

    %prompt> cd ~/rails/redmine/public
    %prompt> wget http://www.gettaskdone.com/redmine-htaccess/htaccess.txt
    %prompt> mv htaccess.txt .htaccess
    

11. Edit Rakefile
    RubyGems 1.6.x is incompatible with the bundled rails 2.3.5. It’s documented in the RubyGems release notes that “RubyGems no longer requires ‘thread’. Rails < 3 will need to add require ‘thread’ to their applications.”
    So we need to add require 'thread' to the Rakefile after the line require 'rake/rdoctask'.
12. Generate a session store secret
    This is required on the trunk version of Redmine at r2493 or above and the released 0.8.7 version or above.
    Redmine stores session data in cookies by default, which requires a secret to be generated. This can be done by running:

    %prompt> cd ~/rails/redmine
    %prompt> RAILS_ENV=production rake config/initializers/session_store.rb
    

13. Edit config/enviroment.rb
    Insert the following code between the bootstrap and the initialize sections in the config/enviroment.rb file:

    if Gem::VERSION >= "1.3.6" 
        module Rails
            class GemDependency
                def requirement
                    r = super
                    (r == Gem::Requirement.default) ? nil : r
                end
            end
        end
    end
    

14. Setup Database
    We have to give redmine its database structure and default values.

    %prompt> cd ~/rails/redmine
    %prompt> RAILS_ENV=production rake db:migrate
    

15. Insert default configuration data in database
    Run the following command:

    %prompt> RAILS_ENV=production rake redmine:load_default_data
    

    This step is optional but highly recommended, as you can define your own configuration from scratch. It will load default roles, trackers, statuses, workflows and enumerations.

16. Rename the ‘vendor/rails’ folder
    Run the following command:

    %prompt> mv vendor/rails vendor/rails.old
    

    The vendor directory generally takes precedence over the other locations where Rails looks for libraries, and if it contains different versions of gems or other items, it can cause conflicts.

For your information, these are the links I used to write this article:

• http://www.gettaskdone.com/portfolio/consulting-portfolio/redmine-at-hostmonster-hosting-account/
• http://www.redmine.org/boards/1/topics/22314
• http://www.redmine.org/issues/7516