HowTo Install Redmine in Ubuntu » History » Version 42

Roland Giesler, 2013-02-05 13:40
Added the symlink creation instruction for /var/cache/redmine/default/plugin_assets

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