HowTo Install Redmine using Debian package » History » Revision 19
Revision 18 (Vítězslav Dvořák, 2012-03-12 20:59) → Revision 19/21 (William Piedfort, 2012-05-19 20:02)
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. 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'@