Project

General

Profile

HowTo Install Redmine in Ubuntu » History » Version 64

Recent Coin, 2013-02-12 17:14
Added another lib dependence in order to get the bundle install to process completely

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