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