Project

General

Profile

HowTo Install Redmine 12x + Mercurial on Ubuntu lucid server » History » Version 13

Dimitry Profus, 2011-09-18 05:44

1 1 Dimitry Profus
h1. How to install Redmine on Ubuntu lucid server
2
3
{{toc}}
4
5 10 Dimitry Profus
h2. Redmine Installation
6 1 Dimitry Profus
7
# Install the LAMP stack
8
<pre>
9
$ sudo tasksel install lamp-server
10
</pre>
11
# Install the required packages
12
<pre>
13 5 Dimitry Profus
$ sudo apt-get install build-essential llibmysqlclient15-dev ibdigest-sha1-perl libgemplugin-ruby libgemplugin-ruby1.8 libruby-extras libruby1.8-extras rails rake ruby rubygems rubygems1.8 ruby1.8-dev subversion libopenssl-ruby1.8 
14 1 Dimitry Profus
</pre>
15
# Install the required Ruby gems
16
<pre>
17
$ sudo gem install rails -v=2.3.11 --no-ri --no-rdoc
18 4 Dimitry Profus
$ sudo gem install rake -v=0.8.7 --no-ri --no-rdoc
19 5 Dimitry Profus
$ sudo gem uninstall rake -v=0.9.2 
20 4 Dimitry Profus
$ sudo gem install i18n -v=0.4.2 --no-ri --no-rdoc
21
$ sudo gem install mysql --no-ri --no-rdoc
22 1 Dimitry Profus
</pre> 
23 5 Dimitry Profus
# Download Redmine into /user/share/redmine directory
24 1 Dimitry Profus
<pre>
25 5 Dimitry Profus
$ sudo svn co http://redmine.rubyforge.org/svn/branches/1.2-stable /usr/share/redmine
26 1 Dimitry Profus
</pre>
27
# Create an empty MySQL database and accompanying user named redmine for example.
28
<pre>
29 5 Dimitry Profus
$ mysql -u root -p
30
(enter the mysql root user password)
31 1 Dimitry Profus
> create database redmine character set utf8;
32
> create user 'redmine'@'localhost' identified by '[password]';
33
> grant all privileges on redmine.* to 'redmine'@'localhost' identified by '[password]';
34
</pre>
35
# Copy config/database.yml.example to config/database.yml and edit this file in order to configure your database settings for "production" environment.
36
<pre>
37 5 Dimitry Profus
$ sudo cp /usr/share/redmine/config/database.yml.example /usr/share/redmine/config/database.yml
38 1 Dimitry Profus
39 5 Dimitry Profus
$ sudo nano /usr/share/redmine/config/database.yml
40 1 Dimitry Profus
41
Modify to the following and save (ctrl+x)
42
43
production:
44
  adapter: mysql
45
  socket: /var/run/mysqld/mysqld.sock
46
  database: redmine
47
  host: localhost
48
  username: redmine
49
  password: [password]
50 5 Dimitry Profus
  encoding: utf8
51 1 Dimitry Profus
</pre>
52 5 Dimitry Profus
# Generate a session store secret.
53
<pre>
54 6 Dimitry Profus
$ cd /usr/share/redmine
55
56 5 Dimitry Profus
$ sudo rake generate_session_store
57
</pre>
58 1 Dimitry Profus
# Create the database structure, by running the following command under the application root directory:
59
<pre>
60 5 Dimitry Profus
$ cd /usr/share/redmine
61 1 Dimitry Profus
62
$ sudo rake db:migrate RAILS_ENV="production" 
63
</pre>
64
# Insert default configuration data in database, by running the following command:
65
<pre>
66
$ sudo RAILS_ENV=production rake redmine:load_default_data
67
</pre>
68
# Setting up permissions
69
<pre>
70 5 Dimitry Profus
$ cd /usr/share/redmine
71 1 Dimitry Profus
$ sudo chown -R www-data:www-data files log tmp public/plugin_assets
72
$ sudo chmod -R 755 files log tmp public/plugin_assets
73
</pre>
74 9 Dimitry Profus
# Test using the webrick web server
75
<pre>
76
$ cd /usr/share/redmine
77
78
$ ruby script/server webrick -e production
79
80
Point your web browser at http://[my server ip]:3000
81
82
You should now see the application welcome page.
83
</pre>
84
85 1 Dimitry Profus
86 5 Dimitry Profus
h2. Apache Integration
87 1 Dimitry Profus
88
# Install the required packages
89
<pre>
90
$ sudo apt-get install libapache2-mod-passenger libapache-dbi-perl libapache2-mod-perl2 libapache2-svn
91
</pre>
92
# Add a symbolic link to the public redmine web directory
93
<pre>
94
$ sudo ln -s /usr/share/redmine/public /var/www/redmine
95
</pre>
96
# Configure Passanger to run as www-data
97
<pre>
98
$ sudo nano /etc/apache2/mods-available/passenger.conf
99
100
Add the follow line and save (ctrl+x)
101
102
PassengerDefaultUser www-data
103
</pre>
104
# Create a new Apache site file
105
<pre> 
106
$ sudo nano /etc/apache2/sites-available/redmine 
107
</pre>
108
Add the following lines and save (ctrl+x)
109
<pre>
110
<VirtualHost *:80>
111
        ServerAdmin webmaster@localhost
112
        DocumentRoot /var/www
113
        ServerName myservername
114
        
115
        RewriteEngine on
116
        RewriteRule   ^/$  /redmine  [R]
117
118
        <Directory /var/www/redmine>
119
                RailsBaseURI /redmine
120
                PassengerResolveSymlinksInDocumentRoot on
121
        </Directory>
122
123
        ErrorLog /var/log/apache2/error.log
124
125
        # Possible values include: debug, info, notice, warn, error, crit,
126
        # alert, emerg.
127
        LogLevel warn
128
129
        CustomLog /var/log/apache2/access.log combined
130
</VirtualHost>
131
</pre>
132
For SSL add the following text instead
133
<pre>
134
<VirtualHost *:443>
135
        ServerAdmin webmaster@localhost
136
        DocumentRoot /var/www
137
        ServerName myservername
138
139
        SSLEngine On
140
        SSLCertificateFile /etc/apache2/ssl/redmine.pem
141
142
        RewriteEngine on
143
        RewriteRule   ^/$  /redmine  [R]
144
145
        <Directory /var/www/redmine>
146
                RailsBaseURI /redmine
147
                PassengerResolveSymlinksInDocumentRoot on
148
        </Directory>
149
150
        ErrorLog /var/log/apache2/error.log
151
152
        # Possible values include: debug, info, notice, warn, error, crit,
153
        # alert, emerg.
154
        LogLevel warn
155
156
        CustomLog /var/log/apache2/access.log combined
157
</VirtualHost>
158
</pre>
159
# Enable the Redmine website
160
<pre>
161
$ sudo a2dissite default
162
$ sudo a2ensite redmine
163
</pre> 
164
# Enable the Passenger and Rewite modules and restart Apache
165
<pre> 
166
$ sudo a2enmod passenger
167
$ sudo a2enmod rewrite
168
$ sudo /etc/init.d/apache2 restart
169 3 Dimitry Profus
</pre> 
170
# Test the setup
171
<pre>
172
Open up your favorite web browser and goto
173
174
http://[my site or ip]/redmine
175
</pre>
176 1 Dimitry Profus
177 5 Dimitry Profus
h2. Mercurial Integration
178 1 Dimitry Profus
179
# Install the latest Mercurial release 
180
<pre>
181 7 Dimitry Profus
$ sudo apt-get install python-software-properties
182 1 Dimitry Profus
$ sudo add-apt-repository ppa:mercurial-ppa/releases
183
$ sudo apt-get update
184
$ sudo apt-get install mercurial  
185
</pre>
186
# Create the hg web directory
187
<pre>
188
$ sudo mkdir -p /var/www/hg/repos
189
</pre>
190
# Create the web cgi script file
191
<pre>
192
$ sudo nano /var/www/hg/hgwebdir.cgi
193
194
Add the following and save
195
196
#!/usr/bin/env python
197
#
198
from mercurial import demandimport; demandimport.enable()
199
from mercurial.hgweb.hgwebdir_mod import hgwebdir
200
import mercurial.hgweb.wsgicgi as wsgicgi
201
application = hgwebdir('hgweb.config')
202
wsgicgi.launch(application)
203
</pre>
204
# Create the cgi web config file 
205
<pre>
206
$ sudo nano /var/www/hg/hgweb.config
207
208
Add the following and save
209
210 8 Dimitry Profus
[paths]
211
/=/var/www/hg/repos/**
212 1 Dimitry Profus
213 8 Dimitry Profus
[web]
214
allow_push = *
215
push_ssl = false
216
allowbz2 = yes
217
allowgz = yes
218
allowzip = yes
219 1 Dimitry Profus
</pre>
220
# Setup permissions
221
<pre>
222
$ sudo chown -R www-data:www-data /var/www/hg
223
$ sudo chmod gu+x /var/www/hg/hgwebdir.cgi
224
</pre>
225 12 Dimitry Profus
# Create a Apache config file
226 1 Dimitry Profus
<pre>
227
$ sudo nano /etc/apache2/conf.d/hg.config
228
229
Add the following and save
230
 
231 11 Dimitry Profus
PerlLoadModule Apache::Redmine
232
ScriptAlias /hg  "/var/www/hg/hgwebdir.cgi"
233
<Location /hg  >
234
	AuthType Basic
235
	AuthName "Mercurial" 
236
	Require valid-user
237 1 Dimitry Profus
238 11 Dimitry Profus
	#Redmine auth
239
	PerlAccessHandler Apache::Authn::Redmine::access_handler
240
	PerlAuthenHandler Apache::Authn::Redmine::authen_handler
241
	RedmineDSN "DBI:mysql:database=redmine;host=localhost" 
242
	RedmineDbUser "redmine" 
243
	RedmineDbPass "password" 
244
</Location>
245 1 Dimitry Profus
</pre>
246
# Add a symbolic link to Redmine.pm
247
<pre>
248 5 Dimitry Profus
$ sudo ln -s /usr/share/redmine/extra/svn/Redmine.pm /usr/lib/perl5/Apache/Redmine.pm
249
$ sudo ln -s /usr/share/redmine/extra/svn/Redmine.pm /usr/lib/perl5/Apache2/Redmine.pm  
250 1 Dimitry Profus
</pre>
251
# Enable the required Apache modules and restart Apache
252
<pre>
253
$ sudo a2enmod perl
254
$ sudo /etc/init.d/apache2 restart
255
</pre>
256 8 Dimitry Profus
# Create a new test repository and project in Redmine
257 1 Dimitry Profus
<pre>
258
$ sudo hg init /var/www/hg/repos/test
259 8 Dimitry Profus
$ sudo chown -R www-data:www-data /var/www/hg/repos/test
260
261
Create a new project with and identifier 'test'
262
263
In the project Settings > Repository set
264
SCM: Mercurial
265
Path to repository: /var/www/hg/repos/test
266
Press the 'Create' button
267
268
Goto to the Repository tab of the test project
269 1 Dimitry Profus
</pre>
270
# View the test repository in the web browser 
271
<pre>
272
> http://[my site name]/hg/test
273
</pre>
274
275 10 Dimitry Profus
h2. Email Integration
276 1 Dimitry Profus
277
# Install and configure Sendmail
278
<pre>
279
$ sudo apt-get install sendmail
280
$ sudo sendmailconfig
281
282
(Answer Yes to all questions which you will be asked)
283
</pre>
284
# Update the Redmine configuration file
285
<pre>
286 5 Dimitry Profus
$ sudo nano /usr/share/redmine/config/configuration.yml
287 1 Dimitry Profus
288
Add the following text and save
289
290
 production:
291
   email_delivery:
292
     delivery_method: :sendmail
293
</pre>