HowTo install Redmine on CentOS 5 » History » Revision 53

Revision 52 (Stephan Schuberth, 2012-03-27 18:02) → Revision 53/115 (Stephan Schuberth, 2012-03-27 18:03)

h1. HowTo install Redmine on CentOS 5 or 6 


 h1. 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 

 h1. Steps to take 

 h2. Install gem and passenger dependencies 

 <pre>yum -y install zlib-devel curl-devel openssl-devel httpd-devel apr-devel apr-util-devel mysql-devel</pre> 

 h2. Get Ruby 

 Things after *#* are comments, and it is no use to type this stuff in ;)  
 <pre>cd ~/Downloads    # YOUR FOLDER OF CHOICE 

 h3. FTP session 

 <pre>ftp> Anonymous    # USERLOGIN 
 ftp> 'none', just hit Enter    # NO PASSWORD 
 ftp> cd /pub/ruby 
 ftp> get ruby-1.8.7.pXXX.tar.gz    # XXX is currently 358, as of 03/2012 
 ftp> bye</pre> 

 h3. Unzip 

 <pre>tar zxvf ruby-1.8.7.pXXX.tar.gz</pre> 

 h3. Install 

 <pre>cd ruby-1.8.7.pXXX 
 make install</pre> 

 h3. Check Installation 

 <pre>ruby -v</pre> 
 If this doesnt work, it is probably because there is no ruby at /usr/bin to be found. If it works, skip directly to "Get Gems 1.4.2". 


 h3. Fix dependencies with a symlink 

 (Only in case _ruby -v_ is *NOT* working) 
 <pre>which ruby    # TO CHECK WHERE IT SHOULD BE 
 whereis ruby    # TO CHECK WHERE IT IS INSTALLED</pre> 
 _which_ returns like /usr/bin/ along with other directories (where ruby is expected to be), and _whereis_ returns like /usr/local/bin/ruby (thats where ruby actually lies). 

 Create the Link: 
 <pre>ln -s /usr/local/bin/ruby /usr/bin/ruby</pre> 
 Check again if it is working: 
 cd ..</pre> 


 h2. Get Gems 1.4.2 (does not work with Gems 1.5) 

 tar zxvf rubygems-1.4.2.tgz 
 cd rubygems-1.4.2 
 ruby setup.rb 
 gem -v 
 which gem 
 cd ..</pre> 

 h2. Install Passenger (requires gcc) 

 <pre>gem install passenger 

 An alternate method is to install mod_passenger RPM for Apache from the following location: 

 RHEL/CentOS 5 
 <pre>rpm -Uvh 
 yum install mod_passenger</pre> 

 RHEL/CentOS 6 
 <pre>rpm --import 
 yum install 
 yum install mod_passenger</pre> 

 h2. Restart Apache 

 <pre>service httpd restart</pre> 

 h2. Download Redmine 

 Download page: 

 tar zxvf redmine-1.3.0.tar.gz</pre> 

 h2. Copy the folder to its HTTP document root folder 

 <pre>cp -av redmine-1.3.0/* /var/www/redmine</pre> 

 h2. Configure Apache to host the documents 

 more information can be found here: [[HowTo configure Apache to run Redmine]] 

 h2. Install Bundler 

 <pre>gem install bundler</pre> 

 h2. Add the Bundler Boot and preinitializer code 

 For more info go to the "Bundler site": 

 h2. Create the Gemfile and register these gems in it 

 <pre>vi /var/www/redmine/Gemfile</pre> 

 <pre># file: /var/www/redmine/Gemfile 
 source "" 
 gem "rake", "0.8.3" 
 gem "rack", "1.1.0" 
 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> 

 <pre>bundle install</pre> 

 h2. Create the Redmine MySQL database 

 <pre>yum install mysql-server 
 chkconfig mysqld on 
 service mysqld start 

 > For MySQL: 
 > start the mysql client (@mysql -u root -p@) and enter the following commands 
 > > <pre>create database redmine character set utf8; 
 create user 'redmine'@'localhost' identified by 'my_password'; 
 grant all privileges on redmine.* to 'redmine'@'localhost'; </pre> 

 > For versions of MySQL prior to 5.0.2 - skip the 'create user' step and instead: 

 > > <pre> grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password';</pre> 

 h2. Configure /var/www/redmine/config/database.yml (rename database.yml.example) 

 h2. Set the production environment (optional) 

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

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

 h2. Generate the session store 

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

 h2. Migrate the database models 

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

 h2. Load default data (optional) 

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

 Follow instructions. 

 h2. Rename dispatch CGI files in /var/www/redmine/public/ 

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

 h2. Edit .htaccess file for CGI dispatch configuration 

 mv htaccess.fcgi.example .htaccess 

 h2. 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 

 h2. Redmine should be fully installed now and fully usable