Project

General

Profile

HowTo Install Redmine using Debian package » History » Revision 20

Revision 19 (William Piedfort, 2012-05-19 20:02) → Revision 20/21 (Dave Hudson, 2012-06-01 14:17)

h1. HowTo Install Redmine using Debian package 

 A redmine debian package is available in squeeze, sid and "lenny-backports":http://backports.org/dokuwiki/doku.php?id=instructions - Does NOT exist anymore - 
 Featuring: 
 * automatic database configuration, 
 * multiple instances support. 

 The core package is redmine. 
 Three packages (redmine-*) provide correct dependencies for mysql, pgsql, sqlite. 

 Several configurations are given as working examples in : 
 /usr/share/doc/redmine/examples 

 Explanations of how the configuration is dealt with are given in : 
 /usr/share/doc/redmine/README.Debian.gz 

 There is no per-instance support for plugins, but those dropped to : 
 /usr/share/redmine/vendor/plugins 
 should be ok. 
 The migrate_plugins task is called upon each (re)configuration or upgrade. 
 Since custom plugins are often bound to a specific redmine version, it is advised 
 to remove them before upgrades. 


 h1. Installation details 

 h2. Install the necessary packages  

 From root console: 

 <pre> 
 apt-get install mysql 
 </pre> 
 during mysql setup, provide a new root password for mysql 

 <pre> 
 apt-get install redmine 
 </pre> 
 during redmine install, select mysql database with local connection, set the admin password for redmine_default database 


 h2. Correct the bug (wrong display): 

 <pre> 
 vi $redmine_dir/vendor/rails/activesupport/lib/active_support/vendor.rb 
 </pre> 

 and modify from 
 gem 'i18n', '>= 0.1.3' 
 in 
 gem 'i18n', '>= 0.1.3', '< 0.4.0'  

 <pre> 
 apt-get install libapache2-mod-passenger 
 </pre> 


 h2. Do some configuration 

 <pre> 
 ln -s /usr/share/redmine/public /var/www/redmine 

 chown -R www-data:www-data /var/www/redmine 
 echo "RailsBaseURI /redmine" > /etc/apache2/sites-available/redmine 
 a2ensite redmine 
 /etc/init.d/apache2 reload 
 /etc/init.d/apache2 restart 
 </pre> 

 h2. Configure email smtp server 

 Copy from template: 
 <pre> 
 cp /usr/share/doc/redmine/examples/email.yml.example /etc/redmine/default/email.yml 
 </pre> 

 Edit (at the end, there are uncommented production / development blocks to be filled in): 
 <pre> 
 vi /etc/redmine/default/email.yml 
 </pre> 

 h2. Run the browser 

 Open http://localhost/redmine 

 Log in as admin / admin 

 After you start Redmine the first time, create a symlink to web server access plugin_assets: 
 <pre> 
 ln -s /var/cache/redmine/default/plugin_assets /usr/share/redmine/public/ 
 </pre> 

 h2. If you receive a "Permission denied – /etc/redmine/default/session.yml", do the following: 

 Edit the apache2/mods-available/passenger.conf: 

 <pre> 
 vi /etc/apache2/mods-available/passenger.conf 
 </pre> 

 and add (or change the existing entry to): 

 <pre> 
 <IfModule mod_passenger.c> 
   PassengerRoot /usr 
   PassengerRuby /usr/bin/ruby 
   PassengerDefaultUser www-data 
 </IfModule> 
 </pre> 

 h2. Futher configuration - SVN 

 Get the API key (settings / repositories) 

 Make a crontab to have repositories generated in the background:  

 <pre> 
 crontab -e 
 </pre> 

 In the editor, paste the following (this runs the scan of the projects and if needed it creates the svn repositories): 
 @/5 * * * * /usr/bin/ruby /usr/share/redmine/extra/svn/reposman.rb --redmine localhost/redmine --svn-dir /usr/home/svn --owner www-data --group www-data --url file:///usr/home/svn --verbose --key=YOUR_API_KEY_HERE --command="/usr/bin/svnadmin create" >> /var/log/reposman.log@ 

 Configure servername/svn, so that svn repositories are available over apache webdav: 
 fixme 

 h2. fix the bug in {{count}} display 

 <pre> 
 vi $redmine_dir/vendor/rails/activesupport/lib/active_support/vendor.rb 
 </pre> 

 or if previous non exists (Debian Squeeze) 

 <pre> 
 vi /usr/lib/ruby/1.8/active_support/vendor.rb 
 </pre> 

 and modify from 
 @gem 'i18n', '>= 0.1.3'@ 
 in 
 @gem 'i18n', '>= 0.1.3', '< 0.4.0'@