Project

General

Profile

HowTo Install Redmine in Ubuntu » History » Version 44

Recent Coin, 2013-02-11 23:33

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 43 Recent Coin
These instructions assume that you have a web server (Apache2) and a database (PostgreSQL or MySQL) already in place.  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 '>'.  
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
For MySQL: >apt-get install apache2 mysql-server mysql-client mysql-common 
46
For PostgreSQL:   >apt-get install apache2 postgresql
47
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
h2. Install Redmine.
80
81 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.
82
83
For MySQL: >apt-get install redmine redmine-mysql
84 44 Recent Coin
For PostgreSQL: >apt-get install redmine redmine-postgresql
85 43 Recent Coin
86 36 Anonymous
87
The second package, _redmine-mysql_, can be replaced by either _redmine-pgsql_ or _redmine-sqlite_ if you want to use either of those databases.
88
89
The installation process should prompt you for all the interesting details.
90
91
Redmine will now be installed in @/usr/share/redmine@ and @/etc/redmine@
92
93
h2. Installing the latest Redmine
94
95
The package with Ubuntu 10.04 is stuck in the 0.9.x branch and Ubuntu 12.04 is stuck in the 1.3.x branch. A PPA exists that has the latest branch here: https://launchpad.net/~ondrej/+archive/redmine
96
97
To install redmine using the PPA:
98
99 38 Yu Kobayashi
> $ sudo add-apt-repository ppa:ondrej/redmine
100
> $ sudo apt-get update
101
> $ sudo apt-get install redmine redmine-mysql
102 36 Anonymous
103
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.
104
Run the following <pre>export http_proxy="http://proxy.your.server:port" and export https_proxy="http:proxy.your.server:port".</pre>
105
106
h2. Configuration
107
108
Symlink @/usr/share/redmine/public@ to your desired web-accessible location. E.g.:
109
110
> $ sudo ln -s /usr/share/redmine/public /var/www/redmine
111
112
By default, passenger runs as 'nobody', so you'll need to fix that. In @/etc/apache2/mods-available/passenger.conf@, add:
113
114 38 Yu Kobayashi
<pre>PassengerDefaultUser www-data</pre>
115 36 Anonymous
116
You'll also need to configure the @/var/www/redmine@ location in @/etc/apache2/sites-available/default@ by adding:
117
118
<pre><Directory /var/www/redmine>
119
RailsBaseURI /redmine
120
PassengerResolveSymlinksInDocumentRoot on
121
</Directory>
122
</pre>
123
124
If you set your AppArmor mysqld profile to complain you ought to set it back to enforce:
125
126
> $ sudo aa-enforce /usr/sbin/mysqld
127
128
Enable passenger:
129
130
> $ sudo a2enmod passenger
131
132
Restart apache2
133
134
> $ sudo service apache2 restart
135
136
and you should be able to access Redmine at: http://redmine.server.ip.address/redmine
137
138
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.
139
140
> $ sudo chmod a+x /usr/share/redmine/public
141
142
h1. Ubuntu 10.04 or 12.04 using WEBrick
143
144
Using Passenger is recommended for the heavy load server. But WEBrick uses less memory.
145
146 39 Yu Kobayashi
Install Redmine: (See also _Installing the latest Redmine_ above)
147 38 Yu Kobayashi
148
> $ sudo apt-get install redmine redmine-mysql
149 36 Anonymous
150
Then, create this for /etc/init/redmine.conf
151
152
<pre>
153
# Redmine
154
155
description "Redmine"
156
157
start on runlevel [2345]
158
stop on runlevel [!2345]
159
160
expect daemon
161
exec ruby /usr/share/redmine/script/server webrick -e production -b 0.0.0.0 -d
162
</pre>
163
164
You can start Redmine by this. You can access by http://example.com:3000/
165
166
> $ sudo service redmine start
167
168
You can stop by this.
169
170
> $ sudo service redmine stop
171
172
h1. Ubuntu 10.04 using mod_cgi
173
174
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:
175
176
> $ sudo tasksel install lamp-server
177
178
Also, the default AppArmor configuration can get in the way, so you may need to set the mysqld profile to complain:
179
180
> $ sudo aa-complain /usr/sbin/mysqld
181
182
As of 10.04, Redmine is available through Ubuntu's package manager, and installation is simple:
183
184
> $ sudo apt-get install redmine redmine-mysql subversion
185
186
The second package, _redmine-mysql_, can be replaced by either _redmine-pgsql_ or _redmine-sqlite_ if you want to use either of those databases.
187
188
The installation process should prompt you for all the interesting details.
189
190
Redmine will now be installed in @/usr/share/redmine@ and @/etc/redmine@
191
192
If you set your AppArmor mysqld profile to complain you ought to set it back to enforce:
193
194
> $ sudo aa-enforce /usr/sbin/mysqld
195
196
h2. Configuration
197
198
> *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.*
199
200
Symlink @/usr/share/redmine/public@ to your desired web-accessible location. E.g.:
201
202
> $ sudo ln -s /usr/share/redmine/public /var/www/redmine
203
204 42 Roland Giesler
Also symlink @/var/cache/redmine/default/plugin_assets@ to your redmine directory. E.g.:
205
206
> $ sudo ln -s /var/cache/redmine/default/plugin_assets /usr/share/redmine/public/
207
208
This will ensure that any graphics or other resources are displayed in any installed add-ons.
209
210 36 Anonymous
The other files that you need to modify/create are as follows:
211
212
@/etc/redmine/default/database.yml@:
213
214
<pre>
215
production:
216
adapter: mysql
217
database: redmine
218
host: localhost
219
username: redmine
220
password: pa55w0rd
221
encoding: utf8
222
</pre>
223
224
@/usr/share/redmine/public/dispatch.cgi@:
225
226
<pre>
227
#!/usr/bin/ruby
228
229
require File.dirname(__FILE__) + "/../config/environment" unless defined?(RAILS_ROOT)
230
231
require "dispatcher"
232
233
ADDITIONAL_LOAD_PATHS.reverse.each { |dir| $:.unshift(dir) if File.directory?(dir) } if defined?(Apache::RubyRun)
234
Dispatcher.dispatch
235
</pre>
236
237
@/usr/share/redmine/public/.htaccess@:
238
239
<pre>
240
RewriteEngine On
241
RewriteBase /redmine
242
RewriteRule ^$ index.html [QSA]
243
RewriteRule ^([^.]+)$ $1.html [QSA]
244
RewriteCond %{REQUEST_FILENAME} !-f
245
RewriteRule ^(.*)$ dispatch.cgi [QSA,L]
246
</pre>
247
248
And that's it! If these instructions didn't work for you, please expand them to include whatever is needed.
249
250
h1. Redmine Installation on Virtual or Normal Ubuntu < 10.04
251
252
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.
253
254
h2. Step 1: Install Ubuntu
255
256
If you are installing on a non-virtual Ubuntu instance, please skip this section.
257
258
*Installing VirtualBox:*
259
260
1.Download the latest version of Sun VirtualBox (version 3.0.10 or newer).
261
2.Install VirtualBox by following the instructions.
262
263
*Installing Ubuntu on VirtualBox:*
264
265
1.Download the latest version of Ubuntu (version 9.10 or newer).
266
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.
267
268
3.While installing Ubuntu you should enter the following configuration:
269
(This suggested configuration is optional, you can enter any names you want.)
270
Q: What is your name? A: Redmine Server
271
Q: What name do you want to use to login? A: redmine
272
Q: Choose to password to keep your account safe? A: redmine
273
Q: What is the name of this computer? A: redmine-server
274
Choose “Log in automatically.” radio button.
275
276
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:
277
> sudo apt-get update
278
> sudo apt-get upgrade
279
280
*Configuring VirtualBox:*
281
282
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.
283
284
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.
285
286
h2. Step 2: Install Redmine
287
288
Once you have a functioning Ubuntu operating system up and running, you can continue with installing Redmine.
289
290
h3. Install dependencies
291
292
The following packages are required to install and run Redmine. Please install them by running @apt-get@ as root:
293
294
>sudo apt-get install package-name
295
296
where @package-name@ is each of:
297
* apache2
298
* apache2-threaded-dev
299
* build-essential
300
* libapache-dbi-perl
301
* libapache2-mod-perl2
302
* libapache2-svn
303
* libdigest-sha1-perl
304
* libgemplugin-ruby
305
* libgemplugin-ruby1.8
306
* libruby-extras
307
* libruby1.8-extras
308
* mongrel
309
* mysql-server
310
* rails
311
* rake
312
* ruby
313
* rubygems
314
* rubygems1.8
315
* ruby1.8-dev
316
* subversion
317
318
_(Could someone please clean up this list?)_
319
320
h3. Package Installation and Setup
321
322
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:
323
> sudo apt-get install
324
> sudo apt-get install
325
(_Surely some missing package names above?_)
326
327
The packages we’re installing above are MySQL, phpMyAdmin, Rails, Ruby Gems, Mongrel and Ruby Dev environment.
328
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”.
329
330
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:
331
> sudo mkdir /opt/redmine
332
> sudo cd /opt/redmine
333
> sudo wget http://rubyforge.org/frs/download.php/66633/redmine-0.8.6.tar.gz
334
> tar -xvf redmine-0.8.6.tar.gz
335
336
h3. Database Setup
337
338
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.
339
Type in “root” and the MySQL “password” you created when installing MySQL.
340
341
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”.
342
343
3.Now, go back to the home screen and click on:
344
“Privileges”
345
“Add a new User”
346
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.
347
In the “Database for user” section, check “Create database with same name and grant all privileges” and click on the “Go” button.
348
349
4.Log out of phpMyAdmin.
350
351
h3. Redmine Database Connection Configuration
352
353
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:
354
> sudo cd /opt/redmine/redmine-0.8.6/config
355
356
2.So now, assuming you’re in the “/opt/redmine/redmine-0.8.6/config” directory, issue:
357
> sudo cp database.yml.example database.yml
358
359
3.Then, open the “database.yml” file, issue:
360
> sudo gedit database.yml
361
… and edit it as in the example for a MySQL database below:
362
363
production:
364
adapter: mysql
365
socket: /var/run/mysqld/mysqld.sock
366
database: redmine
367
host: localhost
368
username: redmine
369
password: [password]
370
371
Then save the “database.yml” file and exit to the command prompt.
372
On Ubuntu the “mysql.sock” is located in /var/run/mysqld/mysqld.sock, as noted in the “config” above.
373
(The standard Redmine installation assumes the socket is located in “/opt/redmine/redmine-0.8.6/tmp/mysqld.sock”.)
374
375
4.Create the database structure, by running the following command under the application root directory (I mean “/opt/redmine/redmine-0.8.6”):
376
> sudo rake db:migrate RAILS_ENV="production"
377
It will create the necessary tables in the redmine database you created earlier and an administrator account.
378
379
5.Insert the default configuration data in to the database, by issuing:
380
> sudo rake redmine:load_default_data RAILS_ENV="production"
381
(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.)
382
383
h3. Setting up Permissions
384
385
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:
386
> sudo mkdir /opt/redmine/redmine-0.8.6
387
388
2.If you haven’t created a Redmine user, do it now by issuing:
389
> sudo useradd redmine
390
391
3.Now, assuming you run Redmine with a redmine user, from your /opt/redmine/redmine-0.8.6 directory issue:
392
> sudo chown -R redmine:redmine files log tmp
393
> sudo chmod -R 755 files log tmp
394
395
h3. Testing the Installation
396
397
1.It should all be working now. Test the installation by running the WEBrick web server issue:
398
> sudo cd /opt/redmine/redmine-0.8.6
399
> sudo ruby script/server -e production
400
401
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.
402
403
*Log in:*
404
405
1.Use default administrator account to log in:
406
Login : admin
407
Password : admin
408
409
2.You can go to Admin & Settings to modify application settings.
410
411
h3. Setting Up Static IP
412
413
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.
414
415
2.Or you should determine the configuration parameters given below, and then you can configure your system to have a static IP address:
416
The desired IP address
417
Network mask and broadcast address
418
Gateway address
419
Your local DNS server address(es)
420
421
h3. Assigning Host Name and Domain for VirtualBox OS
422
423
1.An easier method for adding your IP address - Host name pair configuration to your DNS server . Consult your network administrator.
424
425
h2. Configuring the Passenger Apache module
426
427
Passenger is a module for apache2 that allows Apache to run Ruby on Rails applications. Install it thus:
428
429
>$ sudo gem install passenger
430
431
Then go to the passenger apache2 module installation directory and run @passenger-install-apache2-module@
432
433
> $ cd /var/lib/gems/1.X/gems/passenger-X.X.X/
434
435
> $ sudo bin/passenger-install-apache2-module
436
437
Next, configure Apache:
438
439
In /etc/apache2/mods-available/passenger.load we will add next line
440
441
> LoadModule passenger_module /var/lib/gems/1.X/gems/passenger-X.X.X/ext/apache2/mod_passenger.so
442
443
We have to edit the conf of the passenger apache2 module in /etc/apache2/mods-available/passenger.conf
444
445
> PassengerRoot /var/lib/gems/1.X/gems/passenger-X.X.X
446
> PassengerRuby /usr/bin/ruby1.X
447
448
And now we activate the module
449
450
> $ sudo a2enmod passenger
451
452
Apache virtualhost for redmine web app
453
454
<pre>
455
<VirtualHost *:80>
456
ServerName redmine.server.com
457
458
DocumentRoot /var/www/redmine/public
459
460
ServerAdmin user@server.com
461
LogLevel warn
462
ErrorLog /var/log/apache2/redmine_error
463
CustomLog /var/log/apache2/redmine_access combined
464
465
<Directory /var/www/redmine/public>
466
Options Indexes FollowSymLinks MultiViews
467
AllowOverride None
468
Order allow,deny
469
allow from all
470
</Directory>
471
</VirtualHost>
472
</pre>
473
474
subversion server config in apache
475
476
<pre>
477
<VirtualHost *:80>
478
ServerName svn.server.com
479
ServerAdmin user@server.com
480
ErrorLog /var/log/apache2/svn_error
481
CustomLog /var/log/apache2/svn_access combined
482
<Location /project>
483
DAV svn
484
SVNPath /var/lib/svn/project
485
486
AuthType Basic
487
AuthName "Trac system for Server projects"
488
AuthUserFile "/var/lib/svn/.htpasswd"
489
Require valid-user
490
<LimitExcept GET PROPFIND OPTIONS REPORT>
491
Require valid-user
492
</LimitExcept>
493
</Location>
494
</Virtualhost>
495
</pre>
496
497
h2. Sendmail Server Configuration
498
499
1.Before configuring email support for Redmine, we should download the sendmail application for Ubuntu, issue:
500
501
> sudo apt-get install sendmail
502
503
> sudo sendmailconfig
504
505
(Answer Yes to all questions which you will be asked)
506
507
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:
508
> sudo cd /opt/redmine/redmine-0.8.6/config
509
510 37 João Lencart e Silva
511
512 36 Anonymous
3.So now, assuming you’re in the “/config” directory, issue:
513
> sudo cp email.yml.example email.yml
514
515
4.Then, open the “email.yml” file, issue:
516
> sudo gedit email.yml
517
… and edit it as in the example for sendmail configuration below:
518
519
production:
520
delivery_method: :sendmail
521
sendmail_settings:
522
location: /usr/sbin/sendmail
523
arguments: -i -t
524
address: smtp.example.net
525
port: 25
526
domain: example.net
527
authentication: :none
528
user_name: redmine@example.net
529
password: redmine
530
531
Then save “email.yml” file and exit to the command prompt.
532
533
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”.
534 37 João Lencart e Silva
535
h2. Email configuration for Ubuntu 12.04 with redmine >v1.4.3
536
537
1. Instead of creating an email.yml, edit config/configuration.yml and add a section
538
<pre>
539
production:
540
   email_delivery:
541
     delivery_method: :smtp
542
...</pre>
543
544
or
545
546
<pre>production:
547
   email_delivery:
548
     delivery_method: :sendmail
549
...</pre>
550
551
Please see http://www.redmine.org/projects/redmine/wiki/EmailConfiguration for the correct format of the full email block.
552
553
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:
554
@config.action_mailer.perform_deliveries = false@
555
556
557
558
559 36 Anonymous
560
h2. Subversion Installation and Configuration
561
562
1.Before configuring Subversion support for Redmine, we should download the Subversion application for Ubuntu, issue:
563
> sudo apt-get install subversion
564
565
2.If your Redmine can't find the “subversion” command you can help to find by issuing:
566
· > sudo cd /opt/redmine/redmine-0.8.6/config
567
· > sudo gedit environment.rb
568
· Add ENV['PATH'] = "#{ENV['PATH']}:/subversion/path" line in it.
569
· Save and close the “environment.rb”
570
571
h2. Start Application at Boot Time
572
573
1.To automatically start the application on booting your server you need to modify your “crontab”, issue:
574
> export EDITOR=gedit
575
> crontab -e
576
577
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):
578
@reboot cd /opt/redmine/redmine-0.8.6 ; rm -f log/mongrel.pid ; mongrel_rails start -e production -p 3000 -d
579
580
h2. Backup
581
582
1.Running backups is always a good idea. Redmine backups should include:
583
* data (stored in your redmine database)
584
/usr/bin/mysqldump -u -p | gzip > /path/to/redmine/backup/db/redmine_`date +%y_%m_%d`.gz
585
* attachments (stored in the files directory of your Redmine install)
586
rsync -a /path/to/redmine/files /path/to/redmine/backup/files
587
588
2.Or you can use the bash shell to automate this kind of operation, issue:
589
> sudo cd /opt/redmine/redmine-0.8.6
590
> sudo mkdir backup
591
> sudo mkdir backup/db
592
> sudo mkdir backup/files
593
> sudo gedit backup/runRedmineBackup.bash
594
595
And after open “runRedmineBackup.bash” with gedit, write all commands below:
596
<pre>
597
#!/bin/bash
598
data=`date -I`
599
mysqldump --user=root --password="redmine" --all-databases | gzip > db/backup-$data.sql.gz
600
cd db
601
ftp -i -n << EOF
602
open ftpserver.example.net
603
user username password
604
bin
605
mput backup-$data.sql.gz
606
bye
607
EOF
608
</pre>
609
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:
610
611
> export EDITOR=gedit
612
> crontab -e
613
Add 0 0 * * 0 cd /opt/redmine/redmine-0.8.6/backup ; sh runRedmineBackup.bash commands to crontab to backup database weekly.
614
615
For this to work without any permission problems you have to change the permissions of the files to maximum, issue:
616
617
> sudo chmod -R 777 backup
618
> sudo chown -R redmine:redmine backup
619
620
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..!
621
622
h2. Sources & contributors.
623
624
* Ümit Uzun 06/11/2009.
625
* 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.
626
* Sam Wilson 2010-05-26, formatting changes.
627
* 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.*+
628
629
h2. Additional Sources
630
631 40 Mohd Shakir Zakaria
* http://docs.oseems.com/general/web/redmine/install-in-ubuntu