HowTo install Redmine on CentOS 5 » History » Revision 8

Revision 7 (Thibault B, 2011-08-08 11:22) → Revision 8/115 (Erwin Baeyens, 2011-09-16 16:59)

h1. HowTo install Redmine on CentOS 5 


 h2. Assumptions 

 * Apache is up and running 
 * Apache has previously been used and works quite well  
 * MySQL is up and running 
 * MySQL has previously been used and works quite well 
 * Your are logged as root 
 * The next steps are done successively without errors 

 h2. Steps to take 

 h3. Install gem and passenger dependencies 

 yum -y install zlib-devel curl-devel openssl-devel httpd-devel apr-devel apr-util-devel 

 h3. Get Ruby 

 cd ~/Downloads    # YOUR FOLDER OF CHOICE 
 cd /pub/ruby 
 get ruby-1.8.7.pXXX.tar.gz 
 tar zxvf ruby-1.8.7.pXXX.tar.gz ruby-1.8.7.pXXX 
 cd ruby-1.8.7.pXXX 
 make install 
 ruby -v 
 which ruby 
 cd .. 

 h3. Get Gems 1.4 (does not work with Gems 1.5) 

 tar zxvf rubygems-1.x.tgz rubygems-1.x 
 cd rubygems-1.x 
 ruby setup.rb 
 gem -v 
 which gem 
 cd .. 

 h3. Install Passenger 

 gem install passenger 

 h3. Restart Apache 

 <pre>service httpd restart</pre> 

 h3. Download Redmine 

 tar zxvf redmine-1.x.tar.gz redmine-1.x 

 h3. Copy the folder to its HTTP document root folder 

 <pre>cp -av redmine-1.x/* redmine-1.x /var/www/redmine-1.x</pre> 

 h3. Configure Apache to host the documents 

 h3. Install Bundler 

 <pre>gem install bundler</pre> 

 h3. Add the Bundler Boot and preinitializer code 

 For more info go to the "Bundler site": 

 h3. Create the Gemfile and register these gems in it 

 <pre> cd /var/www/redmine-1.x/ 
 touch Gemfile 
 vi gemfile 

 * source "" 
 * gem @"rake"@, "0.8.3" 
 * gem @"rack"@, "1.0.1" 
 * gem @"i18n"@, "0.4.2" 
 * gem @"rubytree"@, "0.5.2", :require => "tree" 
 * gem @"RedCloth"@, "~>4.2.3", :require => "redcloth" # for CodeRay 
 * gem @"mysql"@ 
 * gem @"coderay"@, "~>0.9.7" 

 <pre>bundle install</pre> 

 h3. Create the Redmine MySQL database 

 h3. Configure database.yml (rename database.yml.example) 

 h3. Set the production environment (optional) 

 Uncomment the following line in file redmine/config/environment.rb: 

 <pre>ENV['RAILS_ENV'] ||= 'production'</pre> 

 h3. Generate the session store 

 <pre>RAILS_ENV=production bundle exec rake generate_session_store</pre> 

 h3. Migrate the database models 

 <pre>RAILS_ENV=production bundle exec rake db:migrate</pre> 

 h3. Load default data (optional) 

 <pre>RAILS_ENV=production bundle exec rake redmine:load_default_data</pre> 

 Follow instructions. 

 h3. Rename dispatch CGI files 

 mv dispatch.cgi.example dispatch.cgi 
 mv dispatch.fcgi.example dispatch.fcgi 
 mv dispatch.rb.example dispatch.rb 

 h3. Edit .htaccess file for CGI dispatch configuration 

 mv htaccess.fcgi.example .htaccess 

 h3. Chown and Chmod files for read/write access for the Apache user 

 cd .. 
 chown -R apache:apache redmine-1.x 
 chmod -R 755 redmine-1.x 

 h3. Redmine should be fully installed now and fully usable