Project

General

Profile

HowTo Install Redmine in Ubuntu » History » Version 54

Recent Coin, 2013-02-12 00:39

1 43 Recent Coin
h1. Step-by-step for Ubuntu 12.04  or Ubuntu 10.04 using Passenger
2 41 Lee Butler
3
[[HowTo_Install_Redmine_on_Ubuntu_step_by_step|A step-by-step guide]] to getting Redmine running on a fresh installation of Ubuntu.
4
5 43 Recent Coin
h2. Assumptions In This Document 
6 36 Anonymous
7 48 Recent Coin
These instructions assume that you have a basic Ubuntu server installation with command line access.  they assume that you have the rights to install a web server (Apache2) and a database (PostgreSQL or MySQL).  They also assume that you have the ability to carry out sudo commands and that you have at least a passing familiarity with the linux OS and file system.  Lines you should type in will be on their own line and will be preceded by a vertical grey bar.
8 36 Anonymous
9 43 Recent Coin
h2. Become root or be prepared to type sudo before every command.  
10 36 Anonymous
11 43 Recent Coin
You can also save yourself a lot of time if you are doing a big install/configuration job by simply becoming 'real root' instead of typing sudo before everything by typing in either of these commands;
12 36 Anonymous
13 43 Recent Coin
>sudo -s
14 1 Umit Uzun
15 43 Recent Coin
 - OR - 
16 1 Umit Uzun
17 43 Recent Coin
>sudo -i
18 1 Umit Uzun
19 43 Recent Coin
Both will ask you to supply your password again and then you will get a # prompt which shows that you are "root" and no longer have to keep typing sudo. 
20 1 Umit Uzun
21 43 Recent Coin
h2. Be sure to run your updates before you start.  
22 1 Umit Uzun
23 43 Recent Coin
Be sure to check your /etc/apt/sources.list  You will probably want to comment out the "backports" and uncomment the extras and partners.  
24
25
>apt-get update
26
27
If you get any key errors for any of the repositories, you can fix them easily.  
28
29
A key error will look something like this:
30
31
W: GPG error: http://extras.ubuntu.com quantal Release: The following signatures couldn't be verified because the public key is not available: NO_PUBKEY 16126D3A3E5C1192
32
33
>gpg --keyserver hkp://subkeys.pgp.net --recv-keys 16126D3A3E5C1192
34
>gpg --export --armor 16126D3A3E5C1192 | sudo apt-key add - 
35
36
Note that the key (16126D3A3E5C1192) is the same in the error message, the key fetch request and the key import request.  What ever key you are missing can be fixed by through this process.  
37
38
39
>apt-get update && apt-get dist-upgrade
40
41
h2. Have your web server and data base installed
42
43
Installing Ubuntu's entire LAMP stack also installs PHP as well as the PHP connectors for apache, mysql, etc. If you are using RoR, installing all of that is probably unnecessary.  As a general rule of practice, it is best not to install anything you don't actually need.  That which isn't installed is not a potential security hole.  The statements below will install apache2 and the proper database.  
44
45 52 Recent Coin
For MySQL: >apt-get install apache2 software-properties-common librmagick-ruby ruby-rmagick mysql-server mysql-client mysql-common 
46
For PostgreSQL:   >apt-get install apache2 software-properties-common librmagick-ruby ruby-rmagick postgresql
47 43 Recent Coin
48
49 44 Recent Coin
If you want to use another web server or data base, that is outside the scope of this document.
50 43 Recent Coin
51
h2. You must install mod_passenger for Apache2. 
52
> apt-get install libapache2-mod-passenger
53
54
Wait for the install to complete then you must enable the module and restart Apache2.
55
56
>a2enmod passenger
57
>service apache2 restart
58
 - OR -
59
>/etc/init.d/apache2 restart
60
61
Mod_passenger should now be enabled and visible to apache.
62
63
h2.Turn off apparmor for a bit so that it doesn't complain while we're installing everything
64
65
> service apparmor stop
66
 - OR -
67
>/etc/init.d/apparmor stop
68
69 44 Recent Coin
You can restart it once everything has been configured.
70 1 Umit Uzun
71 44 Recent Coin
h2. Create your data base and your user for your redmine installation.
72 1 Umit Uzun
73 44 Recent Coin
There are a great many GUI's out there for most databases.  It is strongly recommended never to run your application as your "root" user on your database (e.g. MySQL root for MySQL or 'postgres' user for PostgreSQL).  There are also any number of tutorials on the creation of databases and granting of rights on them, so that it is really outside the scope of this document. These are pretty trivial to find on Google and if you are going to administer database driven applications its very advisable for you to become at least passingly familiar with SQL statements.
74
75
For MySQL:  CREATE 'user'@'hostname' IDENTIFIED BY 'password';  CREATE DATABASE 'myredminedb'; GRANT ALL ON 'myredminedb'.* TO 'user'@'hostname'; FLUSH PRIVILEGES;
76
77
For PostgreSQL: CREATE USER user WITH PASSWORD 'password'; CREATE DATABASE myredminedb;GRANT ALL PRIVILEGES ON DATABASE myredminedb to user;
78
79 46 Recent Coin
NOTE for PostgreSQL Users:  You will have to set the postgres user password before you can connect remotely.  MySQL will force you to set this during the installation but Postgres does not. To so do:
80
81
>su - postgres
82
>psql
83
84
This will take you to the postgres database prompt.  
85
86
>ALTER USER postgres with password 'my-secure-password';
87
88
This will set the password.  You can now proceed to editing the postgres configuration files so that you can connect remotely.
89
90 44 Recent Coin
h2. Install Redmine.
91
92 43 Recent Coin
---If you are happy with the packaged version, the you can use the packages from the Ubuntu repository.   The Ubuntu 10.04 package is stuck in the 0.9.x branch and the Ubuntu 12.04 package is stuck in the 1.3.x branch.
93
94
For MySQL: >apt-get install redmine redmine-mysql
95 47 Recent Coin
For PostgreSQL: >apt-get install redmine redmine-pgsql
96 49 Recent Coin
For SQLite: 
97 43 Recent Coin
98 1 Umit Uzun
99 49 Recent Coin
The PostgreSQL installation will ask for the postgres user password so that it can create its own user, password, database, etc.  
100
101 36 Anonymous
102
The installation process should prompt you for all the interesting details.
103
104 45 Recent Coin
Redmine will now be installed in @/usr/share/redmine@ and the configuration files will be located in @/etc/redmine@
105 36 Anonymous
106
h2. Installing the latest Redmine
107 53 Recent Coin
108 51 Recent Coin
--If you are not happy with the older versions of Redmine that are in the official Ubuntu repositories (10.04 is stuck 0.9.x and 12.04 is stuck at 1.3.x while the current version is 2.2), this section is for you.  You still need to follow the steps in the other sections but this will get you the newer versions from the PPA/Launchpad here: https://launchpad.net/~ondrej/+archive/redmine
109 1 Umit Uzun
110 51 Recent Coin
*NOTE:* If your server is behind a firewall, you will need to export your firewall settings before running add-apt-repository. Otherwise, the command will hang.
111 1 Umit Uzun
112 51 Recent Coin
Run the following commands to export your proxy settings for both http (port 80) and https (port 443):
113
>export http_proxy="http://proxy.your.server:port" 
114
>export https_proxy="http:proxy.your.server:port"
115 1 Umit Uzun
116
117 51 Recent Coin
Otherwise, proceed to add the PPA to the list of repositories for your machine:
118
119
>add-apt-repository ppa:ondrej/redmine
120
>apt-get update
121
122
123
For MySQL: >apt-get install redmine redmine-mysql
124
For PostgreSQL: apt-get install redmine redmine-pgsql
125 36 Anonymous
126 54 Recent Coin
h2. Apache Configuration
127 1 Umit Uzun
128 54 Recent Coin
You have two choices.  You can install Redmine as a dedicate server or you can install Redmine for use as a directory on another server.
129
130
h3. *Dedicated Server Configuration*
131
>cd /etc/apache2/sites-available
132
133
edit default with your choice of editor. 
134
ServerAdministrator youremail@email.com
135
ServerName mydomain.com
136
137
Directly under this directive is 
138
<pre>
139
DocumentRoot /var/www
140
        <Directory />
141
                Options FollowSymLinks
142
                AllowOverride None
143
        </Directory>
144
</pre>
145
146
 
147
Change this to
148
<pre>
149
DocumentRoot /var/www
150
        <Directory />
151
                Options FollowSymLinks
152
                RailsBaseURI /
153
                PassengerResolveSymlinksinDocumentRoot on
154
                AllowOverride None
155
        </Directory>
156
</pre>
157
158
159
160
161
h3. *Shared Server Configuration*
162 36 Anonymous
Symlink @/usr/share/redmine/public@ to your desired web-accessible location. E.g.:
163
164
> $ sudo ln -s /usr/share/redmine/public /var/www/redmine
165
166
By default, passenger runs as 'nobody', so you'll need to fix that. In @/etc/apache2/mods-available/passenger.conf@, add:
167 38 Yu Kobayashi
168 36 Anonymous
<pre>PassengerDefaultUser www-data</pre>
169
170
You'll also need to configure the @/var/www/redmine@ location in @/etc/apache2/sites-available/default@ by adding:
171
172
<pre><Directory /var/www/redmine>
173
RailsBaseURI /redmine
174
PassengerResolveSymlinksInDocumentRoot on
175
</Directory>
176
</pre>
177
178
If you set your AppArmor mysqld profile to complain you ought to set it back to enforce:
179
180
> $ sudo aa-enforce /usr/sbin/mysqld
181
182
Enable passenger:
183
184
> $ sudo a2enmod passenger
185
186
Restart apache2
187
188
> $ sudo service apache2 restart
189
190
and you should be able to access Redmine at: http://redmine.server.ip.address/redmine
191
192
If you receive a "403: Forbidden" error after setting up Redmine, the Redmine 'public' folder may have incorrect permissions set. The executable bit on the public folder must be enabled or you will receive a "403: Forbidden" error when attempting to access Redmine.
193
194
> $ sudo chmod a+x /usr/share/redmine/public
195
196
h1. Ubuntu 10.04 or 12.04 using WEBrick
197
198
Using Passenger is recommended for the heavy load server. But WEBrick uses less memory.
199 39 Yu Kobayashi
200 38 Yu Kobayashi
Install Redmine: (See also _Installing the latest Redmine_ above)
201
202 36 Anonymous
> $ sudo apt-get install redmine redmine-mysql
203
204
Then, create this for /etc/init/redmine.conf
205
206
<pre>
207
# Redmine
208
209
description "Redmine"
210
211
start on runlevel [2345]
212
stop on runlevel [!2345]
213
214
expect daemon
215
exec ruby /usr/share/redmine/script/server webrick -e production -b 0.0.0.0 -d
216
</pre>
217
218
You can start Redmine by this. You can access by http://example.com:3000/
219
220
> $ sudo service redmine start
221
222
You can stop by this.
223
224
> $ sudo service redmine stop
225
226
h1. Ubuntu 10.04 using mod_cgi
227
228
The installation assumes that the web server and database are already in place, so you probably want to install the LAMP stack first if you don't already have it:
229
230
> $ sudo tasksel install lamp-server
231
232
Also, the default AppArmor configuration can get in the way, so you may need to set the mysqld profile to complain:
233
234
> $ sudo aa-complain /usr/sbin/mysqld
235
236
As of 10.04, Redmine is available through Ubuntu's package manager, and installation is simple:
237
238
> $ sudo apt-get install redmine redmine-mysql subversion
239
240
The second package, _redmine-mysql_, can be replaced by either _redmine-pgsql_ or _redmine-sqlite_ if you want to use either of those databases.
241
242
The installation process should prompt you for all the interesting details.
243
244
Redmine will now be installed in @/usr/share/redmine@ and @/etc/redmine@
245
246
If you set your AppArmor mysqld profile to complain you ought to set it back to enforce:
247
248
> $ sudo aa-enforce /usr/sbin/mysqld
249
250
h2. Configuration
251
252
> *Using Ubuntu Server 10.04.1, configuring Redmine via mod_cgi as described in this section does not seem to work. If you can successfully make this work, please update these instructions! Otherwise follow the instructions in the next section for installing on Ubuntu 10.04 using Passenger or WEBrick if mod_cgi does not work for you.*
253
254
Symlink @/usr/share/redmine/public@ to your desired web-accessible location. E.g.:
255
256
> $ sudo ln -s /usr/share/redmine/public /var/www/redmine
257 42 Roland Giesler
258
Also symlink @/var/cache/redmine/default/plugin_assets@ to your redmine directory. E.g.:
259
260
> $ sudo ln -s /var/cache/redmine/default/plugin_assets /usr/share/redmine/public/
261
262
This will ensure that any graphics or other resources are displayed in any installed add-ons.
263 36 Anonymous
264
The other files that you need to modify/create are as follows:
265
266
@/etc/redmine/default/database.yml@:
267
268
<pre>
269
production:
270
adapter: mysql
271
database: redmine
272
host: localhost
273
username: redmine
274
password: pa55w0rd
275
encoding: utf8
276
</pre>
277
278
@/usr/share/redmine/public/dispatch.cgi@:
279
280
<pre>
281
#!/usr/bin/ruby
282
283
require File.dirname(__FILE__) + "/../config/environment" unless defined?(RAILS_ROOT)
284
285
require "dispatcher"
286
287
ADDITIONAL_LOAD_PATHS.reverse.each { |dir| $:.unshift(dir) if File.directory?(dir) } if defined?(Apache::RubyRun)
288
Dispatcher.dispatch
289
</pre>
290
291
@/usr/share/redmine/public/.htaccess@:
292
293
<pre>
294
RewriteEngine On
295
RewriteBase /redmine
296
RewriteRule ^$ index.html [QSA]
297
RewriteRule ^([^.]+)$ $1.html [QSA]
298
RewriteCond %{REQUEST_FILENAME} !-f
299
RewriteRule ^(.*)$ dispatch.cgi [QSA,L]
300
</pre>
301
302
And that's it! If these instructions didn't work for you, please expand them to include whatever is needed.
303
304
h1. Redmine Installation on Virtual or Normal Ubuntu < 10.04
305
306
This page is a guide to installing Redmine on either a virtual or actual installation of the Ubuntu operating system. If you follow all instructions correctly you will have installed your Redmine server successfully in almost an hour.
307
308
h2. Step 1: Install Ubuntu
309
310
If you are installing on a non-virtual Ubuntu instance, please skip this section.
311
312
*Installing VirtualBox:*
313
314
1.Download the latest version of Sun VirtualBox (version 3.0.10 or newer).
315
2.Install VirtualBox by following the instructions.
316
317
*Installing Ubuntu on VirtualBox:*
318
319
1.Download the latest version of Ubuntu (version 9.10 or newer).
320
2.After installing VirtualBox you will create a new virtual operating which will be Linux type and Ubuntu subtype. If you don't know anything about VirtualBox and/or its usage please refer to Google.
321
322
3.While installing Ubuntu you should enter the following configuration:
323
(This suggested configuration is optional, you can enter any names you want.)
324
Q: What is your name? A: Redmine Server
325
Q: What name do you want to use to login? A: redmine
326
Q: Choose to password to keep your account safe? A: redmine
327
Q: What is the name of this computer? A: redmine-server
328
Choose “Log in automatically.” radio button.
329
330
4.When you've finished the installation, open up your new VirtualBox Ubuntu OS and open up a terminal (console) screen and issue these commands:
331
> sudo apt-get update
332
> sudo apt-get upgrade
333
334
*Configuring VirtualBox:*
335
336
1.If you want to reach your VirtualBox Ubuntu OS from a different machine, you have to configure VirtualBox Ubuntu OS's network settings to Bridged Adapter. So you can reach your VirtualBox Ubuntu from an internal IP address easily. Because it get's the same IP block as you from DHCP easily. I mean your guest and host computer is same IP block as different network client.
337
338
2.If you had assigned a static IP to your Network Consult by giving your static ethernet MAC address, you have to assign the unique MAC address your VirtualBox Ubuntu OS by Setting->Network->MAC address initialization box. By this MAC address, you can get a static IP easily or you can configure your Ubuntu system to not use DHCP, instead of that you can assign a static IP manually.
339
340
h2. Step 2: Install Redmine
341
342
Once you have a functioning Ubuntu operating system up and running, you can continue with installing Redmine.
343
344
h3. Install dependencies
345
346
The following packages are required to install and run Redmine. Please install them by running @apt-get@ as root:
347
348
>sudo apt-get install package-name
349
350
where @package-name@ is each of:
351
* apache2
352
* apache2-threaded-dev
353
* build-essential
354
* libapache-dbi-perl
355
* libapache2-mod-perl2
356
* libapache2-svn
357
* libdigest-sha1-perl
358
* libgemplugin-ruby
359
* libgemplugin-ruby1.8
360
* libruby-extras
361
* libruby1.8-extras
362
* mongrel
363
* mysql-server
364
* rails
365
* rake
366
* ruby
367
* rubygems
368
* rubygems1.8
369
* ruby1.8-dev
370
* subversion
371
372
_(Could someone please clean up this list?)_
373
374
h3. Package Installation and Setup
375
376
1.Once you’ve installed the VirtualBox Ubuntu OS and updated it, you need to install a bunch of packages that we will prepare the server for the Redmine installation. So, as root, install the following packages by issuing:
377
> sudo apt-get install
378
> sudo apt-get install
379
(_Surely some missing package names above?_)
380
381
The packages we’re installing above are MySQL, phpMyAdmin, Rails, Ruby Gems, Mongrel and Ruby Dev environment.
382
During the installation of the packages, when MySQL is installed, it will prompt you to create a password. Make sure you remember it. You will need it later to log in to phpMyAdmin. To make things simple you can set all passwords to “redmine”.
383
384
2.Create a new directory for Redmine. I put mine in /opt/redmine. And download the latest version of Redmine in to it with the wget command line downloader and extract it by issuing:
385
> sudo mkdir /opt/redmine
386
> sudo cd /opt/redmine
387
> sudo wget http://rubyforge.org/frs/download.php/66633/redmine-0.8.6.tar.gz
388
> tar -xvf redmine-0.8.6.tar.gz
389
390
h3. Database Setup
391
392
1.Now it’s time to create an empty database for Redmine. As you may have noticed, we installed phpMyAdmin earlier. phpMyAdmin will come in handy now. Head over to http://localhost/phpmyadmin. You should be presented with the phpMyAdmin login screen.
393
Type in “root” and the MySQL “password” you created when installing MySQL.
394
395
2.First, click on “Databases” then, at the bottom of the screen, in the “Create new database” text box create a new database called “redmine” and set “Collation” to “utf8_general_ci”.
396
397
3.Now, go back to the home screen and click on:
398
“Privileges”
399
“Add a new User”
400
Fill out the “Login Information” boxes. Call your user “redmine”. Make sure you remember password you create here. It will be used when you set up the database connection details in Redmine.
401
In the “Database for user” section, check “Create database with same name and grant all privileges” and click on the “Go” button.
402
403
4.Log out of phpMyAdmin.
404
405
h3. Redmine Database Connection Configuration
406
407
1.It’s time to configure the database connection. If you installed Redmine as I did above, then copy “config/database.yml.example” to “config/database.yml” and edit this file in order to configure your database settings for “production” environment. You’ll find the “database.yml.example” issuing:
408
> sudo cd /opt/redmine/redmine-0.8.6/config
409
410
2.So now, assuming you’re in the “/opt/redmine/redmine-0.8.6/config” directory, issue:
411
> sudo cp database.yml.example database.yml
412
413
3.Then, open the “database.yml” file, issue:
414
> sudo gedit database.yml
415
… and edit it as in the example for a MySQL database below:
416
417
production:
418
adapter: mysql
419
socket: /var/run/mysqld/mysqld.sock
420
database: redmine
421
host: localhost
422
username: redmine
423
password: [password]
424
425
Then save the “database.yml” file and exit to the command prompt.
426
On Ubuntu the “mysql.sock” is located in /var/run/mysqld/mysqld.sock, as noted in the “config” above.
427
(The standard Redmine installation assumes the socket is located in “/opt/redmine/redmine-0.8.6/tmp/mysqld.sock”.)
428
429
4.Create the database structure, by running the following command under the application root directory (I mean “/opt/redmine/redmine-0.8.6”):
430
> sudo rake db:migrate RAILS_ENV="production"
431
It will create the necessary tables in the redmine database you created earlier and an administrator account.
432
433
5.Insert the default configuration data in to the database, by issuing:
434
> sudo rake redmine:load_default_data RAILS_ENV="production"
435
(This step is optional but highly recommended, as you can define your own configuration from scratch. It will load default roles, trackers, statuses, work flows and enumerations. While loading default data command prompt wants to given language selection by you.)
436
437
h3. Setting up Permissions
438
439
1.The user who runs Redmine must have write permission on the following sub directories: “files”, “log”, “tmp” (create the last one if not present). You probably already have a “tmp” directory in /opt/redmine/redmine-0.8.6, but if you don’t, create one now by issuing:
440
> sudo mkdir /opt/redmine/redmine-0.8.6
441
442
2.If you haven’t created a Redmine user, do it now by issuing:
443
> sudo useradd redmine
444
445
3.Now, assuming you run Redmine with a redmine user, from your /opt/redmine/redmine-0.8.6 directory issue:
446
> sudo chown -R redmine:redmine files log tmp
447
> sudo chmod -R 755 files log tmp
448
449
h3. Testing the Installation
450
451
1.It should all be working now. Test the installation by running the WEBrick web server issue:
452
> sudo cd /opt/redmine/redmine-0.8.6
453
> sudo ruby script/server -e production
454
455
Once WEBrick has started, point your browser to http://localhost:3000/. Or, if you are using a browser on a computer other than the one you installed Redmine on, point your browser to http://192.168.1.10:3000/ (if that’s the IP address you gave your Redmine server). You should now see the application welcome page.
456
457
*Log in:*
458
459
1.Use default administrator account to log in:
460
Login : admin
461
Password : admin
462
463
2.You can go to Admin & Settings to modify application settings.
464
465
h3. Setting Up Static IP
466
467
1.An easier method for configuring a static IP address is to use your local DHCP server to assign a permanent IP to the VirtualBox OS mac address. That way you will not have to do anything inside VBS. Consult your network administrator.
468
469
2.Or you should determine the configuration parameters given below, and then you can configure your system to have a static IP address:
470
The desired IP address
471
Network mask and broadcast address
472
Gateway address
473
Your local DNS server address(es)
474
475
h3. Assigning Host Name and Domain for VirtualBox OS
476
477
1.An easier method for adding your IP address - Host name pair configuration to your DNS server . Consult your network administrator.
478
479
h2. Configuring the Passenger Apache module
480
481
Passenger is a module for apache2 that allows Apache to run Ruby on Rails applications. Install it thus:
482
483
>$ sudo gem install passenger
484
485
Then go to the passenger apache2 module installation directory and run @passenger-install-apache2-module@
486
487
> $ cd /var/lib/gems/1.X/gems/passenger-X.X.X/
488
489
> $ sudo bin/passenger-install-apache2-module
490
491
Next, configure Apache:
492
493
In /etc/apache2/mods-available/passenger.load we will add next line
494
495
> LoadModule passenger_module /var/lib/gems/1.X/gems/passenger-X.X.X/ext/apache2/mod_passenger.so
496
497
We have to edit the conf of the passenger apache2 module in /etc/apache2/mods-available/passenger.conf
498
499
> PassengerRoot /var/lib/gems/1.X/gems/passenger-X.X.X
500
> PassengerRuby /usr/bin/ruby1.X
501
502
And now we activate the module
503
504
> $ sudo a2enmod passenger
505
506
Apache virtualhost for redmine web app
507
508
<pre>
509
<VirtualHost *:80>
510
ServerName redmine.server.com
511
512
DocumentRoot /var/www/redmine/public
513
514
ServerAdmin user@server.com
515
LogLevel warn
516
ErrorLog /var/log/apache2/redmine_error
517
CustomLog /var/log/apache2/redmine_access combined
518
519
<Directory /var/www/redmine/public>
520
Options Indexes FollowSymLinks MultiViews
521
AllowOverride None
522
Order allow,deny
523
allow from all
524
</Directory>
525
</VirtualHost>
526
</pre>
527
528
subversion server config in apache
529
530
<pre>
531
<VirtualHost *:80>
532
ServerName svn.server.com
533
ServerAdmin user@server.com
534
ErrorLog /var/log/apache2/svn_error
535
CustomLog /var/log/apache2/svn_access combined
536
<Location /project>
537
DAV svn
538
SVNPath /var/lib/svn/project
539
540
AuthType Basic
541
AuthName "Trac system for Server projects"
542
AuthUserFile "/var/lib/svn/.htpasswd"
543
Require valid-user
544
<LimitExcept GET PROPFIND OPTIONS REPORT>
545
Require valid-user
546
</LimitExcept>
547
</Location>
548
</Virtualhost>
549
</pre>
550
551
h2. Sendmail Server Configuration
552
553
1.Before configuring email support for Redmine, we should download the sendmail application for Ubuntu, issue:
554
555
> sudo apt-get install sendmail
556
557
> sudo sendmailconfig
558
559
(Answer Yes to all questions which you will be asked)
560
561
2.It’s time to configure the server connection. Copy “config/email.yml.example” to “config/email.yml” and edit this file in order to configure your database settings for “production” environment. You’ll find the “email.yml.example” issue:
562
> sudo cd /opt/redmine/redmine-0.8.6/config
563 37 João Lencart e Silva
564
565 36 Anonymous
566
3.So now, assuming you’re in the “/config” directory, issue:
567
> sudo cp email.yml.example email.yml
568
569
4.Then, open the “email.yml” file, issue:
570
> sudo gedit email.yml
571
… and edit it as in the example for sendmail configuration below:
572
573
production:
574
delivery_method: :sendmail
575
sendmail_settings:
576
location: /usr/sbin/sendmail
577
arguments: -i -t
578
address: smtp.example.net
579
port: 25
580
domain: example.net
581
authentication: :none
582
user_name: redmine@example.net
583
password: redmine
584
585
Then save “email.yml” file and exit to the command prompt.
586
587 37 João Lencart e Silva
5.It’s time to configure the “environmet.rb” configuration. Open up the “environment.rb” and change “config.action_mailer.perform_deliveries = false” to “config.action_mailer.perform_deliveries = true” then save and close the “environment.rb”.
588
589
h2. Email configuration for Ubuntu 12.04 with redmine >v1.4.3
590
591
1. Instead of creating an email.yml, edit config/configuration.yml and add a section
592
<pre>
593
production:
594
   email_delivery:
595
     delivery_method: :smtp
596
...</pre>
597
598
or
599
600
<pre>production:
601
   email_delivery:
602
     delivery_method: :sendmail
603
...</pre>
604
605
Please see http://www.redmine.org/projects/redmine/wiki/EmailConfiguration for the correct format of the full email block.
606
607
2. **DO NOT CHANGE** environment.rb config.action_mailer.perform_deliveries. The correct way is changing configuration.yml and leaving the default config.action_mailer.perform_deliveries setting to false:
608
@config.action_mailer.perform_deliveries = false@
609
610
611
612 36 Anonymous
613
614
h2. Subversion Installation and Configuration
615
616
1.Before configuring Subversion support for Redmine, we should download the Subversion application for Ubuntu, issue:
617
> sudo apt-get install subversion
618
619
2.If your Redmine can't find the “subversion” command you can help to find by issuing:
620
· > sudo cd /opt/redmine/redmine-0.8.6/config
621
· > sudo gedit environment.rb
622
· Add ENV['PATH'] = "#{ENV['PATH']}:/subversion/path" line in it.
623
· Save and close the “environment.rb”
624
625
h2. Start Application at Boot Time
626
627
1.To automatically start the application on booting your server you need to modify your “crontab”, issue:
628
> export EDITOR=gedit
629
> crontab -e
630
631
2.Your “crontab” file will be presented. This is the list of programs that start at certain times or at boot. Add the following to the “crontab” (all on one line):
632
@reboot cd /opt/redmine/redmine-0.8.6 ; rm -f log/mongrel.pid ; mongrel_rails start -e production -p 3000 -d
633
634
h2. Backup
635
636
1.Running backups is always a good idea. Redmine backups should include:
637
* data (stored in your redmine database)
638
/usr/bin/mysqldump -u -p | gzip > /path/to/redmine/backup/db/redmine_`date +%y_%m_%d`.gz
639
* attachments (stored in the files directory of your Redmine install)
640
rsync -a /path/to/redmine/files /path/to/redmine/backup/files
641
642
2.Or you can use the bash shell to automate this kind of operation, issue:
643
> sudo cd /opt/redmine/redmine-0.8.6
644
> sudo mkdir backup
645
> sudo mkdir backup/db
646
> sudo mkdir backup/files
647
> sudo gedit backup/runRedmineBackup.bash
648
649
And after open “runRedmineBackup.bash” with gedit, write all commands below:
650
<pre>
651
#!/bin/bash
652
data=`date -I`
653
mysqldump --user=root --password="redmine" --all-databases | gzip > db/backup-$data.sql.gz
654
cd db
655
ftp -i -n << EOF
656
open ftpserver.example.net
657
user username password
658
bin
659
mput backup-$data.sql.gz
660
bye
661
EOF
662
</pre>
663
Then save the “runRedmineBackup.bash” file and exit to the command prompt. After creation of runRedmineBackup.bash you can add this bash script to run continually between specified periods. Issue:
664
665
> export EDITOR=gedit
666
> crontab -e
667
Add 0 0 * * 0 cd /opt/redmine/redmine-0.8.6/backup ; sh runRedmineBackup.bash commands to crontab to backup database weekly.
668
669
For this to work without any permission problems you have to change the permissions of the files to maximum, issue:
670
671
> sudo chmod -R 777 backup
672
> sudo chown -R redmine:redmine backup
673
674
That's all. Now we have completely installed Redmine on our virtual Ubuntu OS and can reach it from any machine in our network easily. Congratulations..!
675
676
h2. Sources & contributors.
677
678
* Ümit Uzun 06/11/2009.
679
* Some of the above material comes from Macada's wiki, licenced under the GNU Free Documentation License 1.2. See "Redmine in Ubuntu Jaunty 9.04":http://wiki.ousli.org/index.php/Redmine_in_Ubuntu_Jaunty_9.04 by David 'macada', last modified 2010-02-08, accessed 2010-05-26.
680
* Sam Wilson 2010-05-26, formatting changes.
681
* Allen Yeh 2010-09-08, Added apt-get install subversion into instructions for 10.04 otherwise once redmine is setup an error like this will result this error -> +*The entry or revision was not found in the repository.*+
682
683
h2. Additional Sources
684 40 Mohd Shakir Zakaria
685 1 Umit Uzun
* http://docs.oseems.com/general/web/redmine/install-in-ubuntu