HowTo Install Redmine in Ubuntu » History » Version 65

Recent Coin, 2013-02-12 18:02

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