Project

General

Profile

HowTo Install Redmine in Apache Tomcat » History » Version 7

Stefan Ollinger, 2010-09-30 02:43

1 5 Mischa The Evil
h1. HowTo Install Redmine in Apache Tomcat
2 1 Henning Sprang
3
As I'm running an Apache Tomcat Server already, I wanted to run redmine in it with Jruby, so I won't have to manage a mongrel/passenger setup.
4
5 3 Henning Sprang
It was much easier than I though, and works very well with Redmine version 0.8.0 and 0.8.6 on Ubuntu Karmic with the tomcat6 package available there.
6 1 Henning Sprang
7 3 Henning Sprang
*There is a problem on 0.8.7 not resolved yet! see http://www.redmine.org/issues/4276*
8 1 Henning Sprang
9
10 3 Henning Sprang
h2. Prerequisites and assumptions
11 1 Henning Sprang
12 3 Henning Sprang
Assumption is you have a Redmine install that works in plain ruby, meaning it's working with 
13 6 Stefan Ollinger
@./scripts/server -e production@. If not, check the normal installation docs first first!
14 1 Henning Sprang
15 3 Henning Sprang
I'm using a socket connection to a mysql server runing on the same machine as the Tomcat application server.
16
There might be some extra steps (e.g. configuring jdbc) necessary for a mysql connection via network.
17 1 Henning Sprang
18 3 Henning Sprang
It's also assumed you already have a Tomcat application server installed and running - If you haven't and don't know how to do it, you'll most likely run Redmine the default way with plain ruby.
19
20
Still, for Redmine developers  not too familiar with the Java platform but still willing to test Redmine here, I've added section below on how to setup and run a tomcat server.
21
22
23
h2. Install the necessary tools
24
25
* The Jruby binary (probably just for testing, not used in the deployment? I did not yet uninstall it and test if things still work, but I think they will)
26
** aptitude install jruby1.2 
27
* Go into the redmine directory
28
** @cd redmine-VERSION@
29
* Test running Redmine manually outside the Tomcat Servlet container - just to make sure it works(database, etc.) before deploying it in tomcat: 
30 7 Stefan Ollinger
** @jruby ./script/server -e productionq@
31 1 Henning Sprang
* Install warbler gem - a tool to package rails applications as Java web application .war files:
32 3 Henning Sprang
** @gem install warbler@
33
34
35
h2. Building the .war file
36
37
The .war file is a web application package - the standard way of packaging applications to be deployed in a Java servlet container.
38
39
* Run warble in configuration mode:
40
** @warble config@ - or if warble is not in your path like in my setup: @~/.gem/ruby/1.8/bin/warble config@
41 1 Henning Sprang
* Edit the warbler config:
42 3 Henning Sprang
** @vim config/warble.rb@
43
* change line beginning with @config.dirs...@ to look like this:
44
** @config.dirs = %w(app config lib log vendor tmp extra files lang)@
45 4 Henning Sprang
* Starting with Redmine 0.8.7 (*but not for version before this!*), you also need to create a "session secret":
46
** @rake config/initializers/session_store.rb@
47 3 Henning Sprang
* Run warble again (without config):
48
** @warble@ - or if warble is not in your path like in my setup: ~/.gem/ruby/1.8/bin/warble
49 1 Henning Sprang
50 3 Henning Sprang
You should have a file called @redmine-VERSION.war@ in the redmine directory now.
51 1 Henning Sprang
52 3 Henning Sprang
53
h2. Deploy the web application and Enjoy
54
55
Place the redmine war file into your tomcat webapps directory:
56
57
* @cp redmine-VERSION.war $TOMCAT_HOME/webapps/redmine.war@
58
59
Redmine should be running on http://your-tomcat-host.name:8080/redmine - likely you'll have to adjust hostname and port.
60
61 1 Henning Sprang
62 3 Henning Sprang
63
64
h2. Tomcat setup
65
66
As said above, usually you will have a tomcat already running or at least know how to install it if you read this Howto. But for people willing to play with this for other reasons (e.g. Redmine developers trying to reproduce bugs :) ), here some words about installing tomcat:
67
68
* Install a Java 6 JDK - download from sun or with a package from you linux distribution, on Ubuntu, that is: 
69
** @apt-get install openjdk-6-jdk@
70
* Download Tomcat, for example from a location mentioned at http://tomcat.apache.org/download-60.cg - for example:
71
** @wget http://apache.autinity.de/tomcat/tomcat-6/v6.0.20/bin/apache-tomcat-6.0.20.tar.gz@
72
* Unpack the archive
73
** tar xvfz apache-tomcat-6.0.20.tar.gz
74 1 Henning Sprang
* You'll have a directory (referred to as TOMCAT_HOME in the deployment step above), got into it, and run tomcat:
75
** @sh bin/startup.sh@
76
* Test if tomcat is running by checking http://your-tomcat-host.name:8080
77
78
That's it, you're ready to deploy redmine in this Tomcat server!
79 4 Henning Sprang
80
81
h2. Links that helped me to achieve this:
82
83
* http://musingsofaprogrammingaddict.blogspot.com/2008/11/redmine-on-jruby-and-glassfish.html
84
* http://www.digitalsanctum.com/2007/07/24/jruby-deploying-a-rails-application-on-tomcat/