Project

General

Profile

HowTo Install Redmine using Debian package » History » Revision 12

Revision 11 (Piotr Serwa, 2011-02-09 03:39) → Revision 12/21 (Jérémy Lal, 2011-03-01 01:05)

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 
 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 Currently there 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. support, although it's on the way. 


 h1. Installation details 

 h2. Install the necessary packages  

 From root console: 

 @apt-get install mysql@ 
 during mysql setup, provide a new root password for mysql 

 @apt-get install redmine@ 
 during redmine install, select mysql database with local connection, set the admin password for redmine_default database 


 h2. Correct the bug (wrong display): 

 vi $redmine_dir/vendor/rails/activesupport/lib/active_support/vendor.rb 

 and modify from 
 gem 'i18n', '>= 0.1.3' 
 in 
 gem 'i18n', '>= 0.1.3', '< 0.4.0'  
 @apt-get install libapache2-mod-passenger@ 


 h2. Do some configuration 

 @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@ 

 h2. Configure email smtp server 

 Copy from template: 
 @cp /usr/share/doc/redmine/examples/email.yml.example /etc/redmine/default/mail.yml@ 

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

 h2. Run the browser 

 Open http://localhost/redmine 

 Log in as admin / admin 

 h2. Futher configuration - SVN 

 Get the API key (settings / repositories) 

 Make a crontab to have repositories generated in the background:  

 @crontab -e@ 

 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 

 @vi $redmine_dir/vendor/rails/activesupport/lib/active_support/vendor.rb@ 

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