Redmine

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