Project

General

Profile

HowTo Install Redmine 212 in Ubuntu 1210 and Apache Passenger » History » Version 2

Julian Perelli, 2012-11-07 18:29

1 1 Julian Perelli
h1. HowTo Install Redmine 212 in Ubuntu 1210 and Apache Passenger
2
3
Inspired in "HowTo Install Redmine 210 on Debian Squeeze with Apache Passenger", from this same wiki, so meta-kudos, to the original authors.
4
5
h2. Assumptions
6
7
* We will be using redmine.example.com; so every time you see this below, replace it by your own domain
8
* If you are behind a proxy, you could do export http_proxy="http://proxy.domain.tld:port" and the installation should work ok.
9
10
h2. Warming up
11
12
We will first need to install basic packages:
13
<pre>
14
apt-get install ruby rubygems libruby libapache2-mod-passenger
15
</pre>
16
Download the latest version of Redmine (2.1.2 in our case) and untar it, then move it to /usr/local/share
17
<pre>
18 2 Julian Perelli
wget http://rubyforge.org/frs/download.php/76495/redmine-2.1.2.tar.gz
19 1 Julian Perelli
tar -xzvf redmine-2.1.2.tar.gz
20
ln /usr/local/share/redmine-2.1.2 /usr/local/share/redmine
21
chown -R root:root /usr/local/share/redmine-2.1.2
22
</pre>
23
24 2 Julian Perelli
Install development libraries for MySQL and Imagick:
25 1 Julian Perelli
<pre>
26 2 Julian Perelli
apt-get install libmysqlclient-dev libmagickcore-dev libmagickwand-dev (install shitload of packages)
27 1 Julian Perelli
</pre>
28
29
h2. Running the Gem stuff
30
31
Install Bundler (removing useless module, which would otherwise create dependencies):
32
<pre>
33
gem install bundler
34
cd /usr/local/share/redmine/
35
/var/lib/gems/1.8/bin/bundle install --without development test postgresql sqlite
36
</pre>
37
38
h2. Configuration
39
40
Copy config/database.yml.example to config/database.yml and edit this file in order to configure your database settings for "production" environment.
41
Example for a MySQL database using ruby1.8 or jruby:
42
<pre>
43
production:
44
  adapter: mysql
45
  database: redmine
46
  host: localhost
47
  username: redmine
48
  password: my_password
49
</pre>
50
51
Generate a session store secret:
52
<pre>
53
/var/lib/gems/1.8/bin/rake generate_secret_token
54
</pre>
55
56
Generate the database structure:
57
<pre>
58
RAILS_ENV=production /var/lib/gems/1.8/bin/rake db:migrate
59
</pre>
60
61
Generate default configuration data:
62
<pre>
63
RAILS_ENV=production /var/lib/gems/1.8/bin/rake redmine:load_default_data
64
</pre>
65
(using “es” for Spanish language in terminal prompt)
66
67
Setup config file in config/configuration.yml
68
69
Change database_ciphr_key: *******
70
<pre>
71
/var/lib/gems/1.8/bin/rake db:encrypt RAILS_ENV=production
72
</pre>
73
74
h2. Apache
75
76
Setup Apache’s VirtualHost config
77
78
<pre>
79
# 8080 in this case is because we use a reverse proxy before Apache. Otherwise simply use "*:80"
80
81
<VirtualHost *:8080>
82
 ServerName redmine.example.com
83
 DocumentRoot /usr/local/share/redmine/public
84
 <Directory /usr/local/share/redmine/public>
85
   AllowOverride all
86
   Options -MultiViews
87
 </Directory>
88
</VirtualHost>
89
</pre>
90
91
Once you enable this virtual host (a2ensite redmine.example.com) and reload Apache (/etc/init.d/apache2/reload), you should see your site running on http://redmine.example.com.
92
93
The default login/password is admin/admin (don't forget to change this).
94
95
h2. Sources of inspiration
96
97
We used the following resources as a starting point. Thanks to their respective authors.
98
99
* http://madpropellerhead.com/random/20100820-installing-redmine-on-debian-with-apache (outdated, for Lenny)
100
* http://www.redmine.org/projects/redmine/wiki/RedmineInstall
101
* http://hodza.net/2012/03/15/howto-install-redmine-on-debian-6-squeeze-ruby-on-rails-apache2-passenger/
102
* http://www.redmine.org/projects/redmine/wiki/HowTo_Install_Redmine_on_Debian_with_Ruby-on-Rails_and_Apache2-Passenger