Project

General

Profile

HowTo Install Redmine using Debian package » History » Version 17

Rodolfo Pilas, 2012-02-15 04:48
plugin_assets move to last step

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 14 Pier-Olivier Clement
<pre>
32
apt-get install mysql
33
</pre>
34 3 Piotr Serwa
during mysql setup, provide a new root password for mysql
35 1 Jérémy Lal
36 14 Pier-Olivier Clement
<pre>
37 15 Pier-Olivier Clement
apt-get install redmine
38 14 Pier-Olivier Clement
</pre>
39 3 Piotr Serwa
during redmine install, select mysql database with local connection, set the admin password for redmine_default database
40 2 Piotr Serwa
41 10 Piotr Serwa
42
h2. Correct the bug (wrong display):
43 1 Jérémy Lal
44 14 Pier-Olivier Clement
<pre>
45 1 Jérémy Lal
vi $redmine_dir/vendor/rails/activesupport/lib/active_support/vendor.rb
46 14 Pier-Olivier Clement
</pre>
47 10 Piotr Serwa
48
and modify from
49 3 Piotr Serwa
gem 'i18n', '>= 0.1.3'
50 1 Jérémy Lal
in
51
gem 'i18n', '>= 0.1.3', '< 0.4.0' 
52
53 14 Pier-Olivier Clement
<pre>
54
apt-get install libapache2-mod-passenger
55
</pre>
56 1 Jérémy Lal
57 14 Pier-Olivier Clement
58 1 Jérémy Lal
h2. Do some configuration
59
60 14 Pier-Olivier Clement
<pre>
61
ln -s /usr/share/redmine/public /var/www/redmine
62 2 Piotr Serwa
63 14 Pier-Olivier Clement
chown -R www-data:www-data /var/www/redmine
64
echo "RailsBaseURI /redmine" > /etc/apache2/sites-available/redmine
65
a2ensite redmine
66
/etc/init.d/apache2 reload
67
/etc/init.d/apache2 restart
68
</pre>
69
70 1 Jérémy Lal
h2. Configure email smtp server
71 4 Piotr Serwa
72
Copy from template:
73 14 Pier-Olivier Clement
<pre>
74
cp /usr/share/doc/redmine/examples/email.yml.example /etc/redmine/default/email.yml
75
</pre>
76 13 Søren Jensen
77 3 Piotr Serwa
Edit (at the end, there are uncommented production / development blocks to be filled in):
78 14 Pier-Olivier Clement
<pre>
79
vi /etc/redmine/default/email.yml
80
</pre>
81 1 Jérémy Lal
82 6 Piotr Serwa
h2. Run the browser
83 1 Jérémy Lal
84
Open http://localhost/redmine
85
86
Log in as admin / admin
87 17 Rodolfo Pilas
88
After you start Redmine the first time, create a symlink to web server access plugin_assets:
89
<pre>
90
ln -s /var/cache/redmine/default/plugin_assets /usr/share/redmine/public/
91
</pre>
92 6 Piotr Serwa
93 7 Piotr Serwa
h2. Futher configuration - SVN
94 1 Jérémy Lal
95 8 Piotr Serwa
Get the API key (settings / repositories)
96
97
Make a crontab to have repositories generated in the background: 
98
99 14 Pier-Olivier Clement
<pre>
100
crontab -e
101
</pre>
102 9 Piotr Serwa
103
In the editor, paste the following (this runs the scan of the projects and if needed it creates the svn repositories):
104 6 Piotr Serwa
@/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@
105
106
Configure servername/svn, so that svn repositories are available over apache webdav:
107 11 Piotr Serwa
fixme
108
109
h2. fix the bug in {{count}} display
110
111 14 Pier-Olivier Clement
<pre>
112
vi $redmine_dir/vendor/rails/activesupport/lib/active_support/vendor.rb
113
</pre>
114 11 Piotr Serwa
115
and modify from
116 1 Jérémy Lal
@gem 'i18n', '>= 0.1.3'@
117
in
118
@gem 'i18n', '>= 0.1.3', '< 0.4.0'@