Project

General

Profile

HowTo Install Redmine using Debian package » History » Version 13

Søren Jensen, 2011-06-22 18:35
Changed mail.yml to email.yml as that is the proper filename for outgoing email/notification support

1 1 Jérémy Lal
h1. HowTo Install Redmine using Debian package
2
3
A redmine debian package is available in squeeze, sid and "lenny-backports":http://backports.org/dokuwiki/doku.php?id=instructions
4
Featuring:
5
* automatic database configuration,
6
* multiple instances support.
7
8
The core package is redmine.
9
Three packages (redmine-*) provide correct dependencies for mysql, pgsql, sqlite.
10
11 12 Jérémy Lal
Several configurations are given as working examples in :
12
/usr/share/doc/redmine/examples
13
14
Explanations of how the configuration is dealt with are given in :
15
/usr/share/doc/redmine/README.Debian.gz
16
17
There is no per-instance support for plugins, but those dropped to :
18
/usr/share/redmine/vendor/plugins
19
should be ok.
20
The migrate_plugins task is called upon each (re)configuration or upgrade.
21
Since custom plugins are often bound to a specific redmine version, it is advised
22
to remove them before upgrades.
23 2 Piotr Serwa
24
25
h1. Installation details
26
27 3 Piotr Serwa
h2. Install the necessary packages 
28 2 Piotr Serwa
29 3 Piotr Serwa
From root console:
30 1 Jérémy Lal
31 3 Piotr Serwa
@apt-get install mysql@
32
during mysql setup, provide a new root password for mysql
33 1 Jérémy Lal
34 3 Piotr Serwa
@apt-get install redmine@
35
during redmine install, select mysql database with local connection, set the admin password for redmine_default database
36 2 Piotr Serwa
37 10 Piotr Serwa
38
h2. Correct the bug (wrong display):
39
40
vi $redmine_dir/vendor/rails/activesupport/lib/active_support/vendor.rb
41
42
and modify from
43
gem 'i18n', '>= 0.1.3'
44
in
45
gem 'i18n', '>= 0.1.3', '< 0.4.0' 
46 3 Piotr Serwa
@apt-get install libapache2-mod-passenger@
47 2 Piotr Serwa
48 3 Piotr Serwa
49
h2. Do some configuration
50
51 1 Jérémy Lal
@ln -s /usr/share/redmine/public /var/www/redmine@
52 2 Piotr Serwa
@chown -R www-data:www-data /var/www/redmine@
53
@echo "RailsBaseURI /redmine" > /etc/apache2/sites-available/redmine@
54
@a2ensite redmine@
55
@/etc/init.d/apache2 reload@
56
@/etc/init.d/apache2 restart@
57
58 4 Piotr Serwa
h2. Configure email smtp server
59
60
Copy from template:
61 13 Søren Jensen
@cp /usr/share/doc/redmine/examples/email.yml.example /etc/redmine/default/email.yml@
62 4 Piotr Serwa
63 5 Piotr Serwa
Edit (at the end, there are uncommented production / development blocks to be filled in):
64 13 Søren Jensen
@vi /etc/redmine/default/email.yml@
65 4 Piotr Serwa
66 3 Piotr Serwa
h2. Run the browser
67
68
Open http://localhost/redmine
69 4 Piotr Serwa
70 1 Jérémy Lal
Log in as admin / admin
71 6 Piotr Serwa
72
h2. Futher configuration - SVN
73
74 7 Piotr Serwa
Get the API key (settings / repositories)
75 1 Jérémy Lal
76 8 Piotr Serwa
Make a crontab to have repositories generated in the background: 
77
78
@crontab -e@
79
80 9 Piotr Serwa
In the editor, paste the following (this runs the scan of the projects and if needed it creates the svn repositories):
81
@/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@
82 6 Piotr Serwa
83
Configure servername/svn, so that svn repositories are available over apache webdav:
84
fixme
85 11 Piotr Serwa
86
h2. fix the bug in {{count}} display
87
88
@vi $redmine_dir/vendor/rails/activesupport/lib/active_support/vendor.rb@
89
90
and modify from
91
@gem 'i18n', '>= 0.1.3'@
92
in
93
@gem 'i18n', '>= 0.1.3', '< 0.4.0'@