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