Project

General

Profile

HowTo Install Redmine on Debian Wheezy Testing with MySQL and Apache2-Passenger » History » Version 3

Gergely Szabo, 2011-03-29 15:25

1 1 Gergely Szabo
h1. Installation on Debian Wheezy Testing
2
3
This page describes the installation of Redmine on Debian Wheezy Testing, as of 29 March 2011.
4
It's actually a Linux Mint Debian Edition (LMDE) virtual server.
5
6 2 Gergely Szabo
First, the most important fact: it does not work out of the box. But it's very easy to fix (thanks to Jérémy Lal). See below.
7 1 Gergely Szabo
8
The used configuration contains an Apache2 webserver, its Ruby-interface Passenger and a MySQL database.
9
10
h2. Preparation
11
12 3 Gergely Szabo
All command lines below assume you're root. And no, the # symbol is not a comment, it's your root prompt. :-)
13 1 Gergely Szabo
<pre>
14
# apt-get update
15
# apt-get install apache2
16
# apt-get install mysql-server
17
</pre>
18
19
The mysql-server installation will guide you through the process of creating an administrative (root) account. Don't forget the password!
20
21
h2. Install Redmine
22
23
This is the tricky part. Debian Wheezy contains Redmine 1.0.5-1, which requires RubyGems 1.3.x or 1.4.x. But Wheezy comes with RubyGems 1.6.2. It breaks during installation. Click for related "Redmine Wiki page":http://www.redmine.org/projects/redmine/wiki/RedmineInstall.
24
25
There are two ways out:
26
* downgrade RubyGems
27
* take a much newer Redmine (1.1.2) from Debian Experimental
28
29
I chose the second option, as the new Gantt-charts are also available from 1.1.0.
30
31 2 Gergely Szabo
First, let's enable the Debian Experimental repositories (see "Debian Wiki":http://wiki.debian.org/DebianExperimental):
32 1 Gergely Szabo
33
Add the line below to /etc/apt/sources.list:
34
<pre>
35
deb http://ftp.debian.org/debian experimental main
36
</pre>
37
38
Then install Redmine 1.1.2:
39
<pre>
40
# apt-get update
41
# apt-get -t experimental install redmine-mysql
42
# apt-get -t experimental install redmine
43
# apt-get install libapache2-mod-passenger
44
</pre>
45
46
Redmine's missing dependencies will be installed too, mostly exotic Ruby-related stuff (ruby, rails, rake etc.)
47
48
Redmine installation will also prompt you for the MySQL admin password (I told you to remember it), then it'll create the database called redmine_default and MySQL user redmine. You can specify its password or let the installer generate a random password.
49
50
All database settings, including the password, are stored here:
51
<pre>
52
/etc/redmine/default/database.yml
53
</pre>
54
55
h2. Start Redmine
56
57
We have to configure the Apache2 webserver to start running the Redmine application.
58
59
Create a symlink from the webserver doc root to redmine:
60
<pre>
61
# ln -s /usr/share/redmine/public /var/www/redmine
62
</pre>
63
64
Passenger should run as user www-data (same as Apache2). Add the line below to /etc/apache2/mods-available/passenger.conf:
65
<pre>
66
    PassengerDefaultUser www-data
67
</pre>
68
69
Add the /var/www/redmine location in /etc/apache2/sites-available/default:
70
<pre>
71
    <Directory /var/www/redmine>
72
        RailsBaseURI /redmine
73
        PassengerResolveSymlinksInDocumentRoot on
74
    </Directory>
75
</pre>
76
77
Usually the Passenger module is enabled during installation (libapache2-mod-passenger). If not, enable it manually:
78
<pre>
79
# a2enmod passenger
80
</pre>
81
82
And last but not least, restart apache2:
83
<pre>
84
# /etc/init.d/apache2 restart
85
</pre>
86
87
Your new Communist Underground Movement a.k.a. Redmine is now available here:
88
<pre>
89
http://yourservername/redmine
90
</pre>