Info: Configure Redmine on cpanel hosting account with sending and receiving emails.

Posted on November 19, 2013 Updated on November 19, 2013

Wiki : http://en.wikipedia.org/wiki/Redmine

Redmine is a free and open source, web-based project management and bug-tracking tool. It includes a calendar and Gantt charts to aid visual representation of projects and their deadlines. It handles multiple projects. Redmine provides integrated project management features, issue tracking, and support for various version control systems.
The design of Redmine is significantly influenced by Trac, a software package with some similar features.
Redmine is written using the Ruby on Rails framework. It is cross-platform and cross-database. It is part of the Bitnami app library that provides an installer and virtual machine for ease of deployment.

Before starting installation you have to make sure that Ruby on rails is working fine in your environment, If not you can follow the installation document for more help.

Installaing Ruby on Rails with Cpanel : https://enlook.wordpress.com/2013/11/19/howto-install-ruby-on-rails-with-cpanel/

Once you have done, then start the redmine installation steps.

Login to the terminal using primary account logins.

#ssh myaccount@mydomain.com

1. Create rails_app folder and redmine folder within it then go inside that folder

   # mkdir -p ~/rails_apps/redmine/
   # cd ~/rails_apps/redmine/

2.  Download redmine redmine-2.3.3 or latest stable version, extract it and move the content out of it, then delete the files not being used.

   1. # wget http://files.rubyforge.vm.bytemark.co.uk/redmine/redmine-2.3.3.tar.gz
      # tar -zxvf redmine-2.3.3.tar.gz
      # mv redmine-2.3.3/* ./
      # rm -rf redmine-2.3.3/

3. Move example files where they can be used

   # cd config
   # mv database.yml.example database.yml
   # mv configuration.yml.example configuration.yml

4. Creating the MySQL Database/User/Password
   Login to Cpanel account, Create a database , user and grant full privilege to the new user for the particular database.
   
5. Modifying your database.yml file.

   # vi database.yml
   production:
   adapter: mysql
   database: redmine
   host: localhost
   username: myaccount_databaseuser
   password: newpassowd
   encoding: utf8

6. Updating the ~/rails_apps/redmine/public/.htaccess file

   # cd ../public/
   # pwd

   1. You should see something similar to this.

   /home/myaccountuser/rails_apps/redmine/public

   Add these lines

   Options -MultiViews
   PassengerResolveSymlinksInDocumentRoot on
   #Set this to whatever environment you'll be running in
   RailsEnv production
   RackBaseURI /
   SetEnv GEM_HOME /home/myaccountuser/rails_apps/redmine/public
   
   # set to resolve avoid rails control to the folder for image resolution   
   RewriteEngine On
   RewriteCond %{REQUEST_URI} ^/images.*
   RewriteRule .* - [L]

7. Create a subdomain eg: projects.mydomain.com
   Follow cpanel procedure to create subdomain. 
8. Remove projects folder inside public_html and create symbolic link.

   # rm -rf ~/public_html/projects

   Creating the symlink

   # ln -s ~/rails_app/redmine/public ~/public_html/projects

9. Updating Environment variables in ~/.bashrc file
   Add these lines to the bottom of your ~/.bashrc file

              export HPATH=$HOME
              export GEM_HOME=$HPATH/ruby/gems
              export GEM_PATH=$GEM_HOME:/lib64/ruby/gems/1.9.3
              export GEM_CACHE=$GEM_HOME/cache
              export PATH=$PATH:$HPATH/ruby/gems/bin
              export PATH=$PATH:$HPATH/ruby/gems

   after which source your .bashrc file

           # source ~/.bashrc

   You will then need to check your rails version

           rails -v && rake --version && gem -v

   You should get this message

   

   Rails 4.0.1
   rake, version 0.9.2.2
   1.8.23

10. Running bundle install

    # cd ~/rails_apps/redmine/
    # bundle install
    # rake generate_session_store

11. Running generate_session_store or generate_secret_token

    1. # rake generate_session_store

    If you get an error saying that command is deprecated, run this command instead;

     # rake generate_secret_token

12. Start the site session

    # rake db:migrate RAILS_ENV=production

13. Configuring outgoing emailsUpdate the setting in configuration.yml

    default:
     email_delivery:
     delivery_method: :smtp
     smtp_settings:
     address: localhost
     port: 25
     domain: mydomain.com
     authentication: :none
    enable_starttls_auto: false

    Now the redmine have capable to send emails using exim install in the cpanel server.

14. Configuring Incomming emails for IMAPCreate a cron job for the script to get continuous email feaching
    

    For the first this script must execute from the terminal, so it will display error if any.

    /usr/bin/rake -f /home1/innovat4/rails_apps/redmine/Rakefile --silent redmine:email:receive_imap RAILS_ENV="production" port=143 host=mydomain.com username=projects@mydomain.com password=myemailpassword

    For more help follow the official link http://www.redmine.org/projects/redmine/wiki/RedmineReceivingEmails#Enabling-unknown-users-to-create-issues-by-email

Note : Each configuration required rails environment reboot for that you can follow the simple way.

# touch ~/rails_app/redmine/tmp/reboot.txt