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 1 Henning Sprang
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 1 Henning Sprang
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 1 Henning Sprang
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 3 Henning Sprang
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 3 Henning Sprang
20 3 Henning Sprang
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 3 Henning Sprang
22 3 Henning Sprang
23 3 Henning Sprang
h2. Install the necessary tools
24 3 Henning Sprang
25 3 Henning Sprang
* 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 3 Henning Sprang
** aptitude install jruby1.2 
27 3 Henning Sprang
* Go into the redmine directory
28 3 Henning Sprang
** @cd redmine-VERSION@
29 3 Henning Sprang
* 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 3 Henning Sprang
34 3 Henning Sprang
35 3 Henning Sprang
h2. Building the .war file
36 3 Henning Sprang
37 3 Henning Sprang
The .war file is a web application package - the standard way of packaging applications to be deployed in a Java servlet container.
38 3 Henning Sprang
39 3 Henning Sprang
* Run warble in configuration mode:
40 3 Henning Sprang
** @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 3 Henning Sprang
* change line beginning with @config.dirs...@ to look like this:
44 3 Henning Sprang
** @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 4 Henning Sprang
** @rake config/initializers/session_store.rb@
47 3 Henning Sprang
* Run warble again (without config):
48 3 Henning Sprang
** @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 3 Henning Sprang
h2. Deploy the web application and Enjoy
54 3 Henning Sprang
55 3 Henning Sprang
Place the redmine war file into your tomcat webapps directory:
56 3 Henning Sprang
57 3 Henning Sprang
* @cp redmine-VERSION.war $TOMCAT_HOME/webapps/redmine.war@
58 3 Henning Sprang
59 3 Henning Sprang
Redmine should be running on http://your-tomcat-host.name:8080/redmine - likely you'll have to adjust hostname and port.
60 3 Henning Sprang
61 1 Henning Sprang
62 3 Henning Sprang
63 3 Henning Sprang
64 3 Henning Sprang
h2. Tomcat setup
65 3 Henning Sprang
66 3 Henning Sprang
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 3 Henning Sprang
68 3 Henning Sprang
* Install a Java 6 JDK - download from sun or with a package from you linux distribution, on Ubuntu, that is: 
69 3 Henning Sprang
** @apt-get install openjdk-6-jdk@
70 3 Henning Sprang
* Download Tomcat, for example from a location mentioned at http://tomcat.apache.org/download-60.cg - for example:
71 3 Henning Sprang
** @wget http://apache.autinity.de/tomcat/tomcat-6/v6.0.20/bin/apache-tomcat-6.0.20.tar.gz@
72 3 Henning Sprang
* Unpack the archive
73 3 Henning Sprang
** 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 1 Henning Sprang
** @sh bin/startup.sh@
76 1 Henning Sprang
* Test if tomcat is running by checking http://your-tomcat-host.name:8080
77 1 Henning Sprang
78 1 Henning Sprang
That's it, you're ready to deploy redmine in this Tomcat server!
79 4 Henning Sprang
80 4 Henning Sprang
81 4 Henning Sprang
h2. Links that helped me to achieve this:
82 4 Henning Sprang
83 4 Henning Sprang
* http://musingsofaprogrammingaddict.blogspot.com/2008/11/redmine-on-jruby-and-glassfish.html
84 4 Henning Sprang
* http://www.digitalsanctum.com/2007/07/24/jruby-deploying-a-rails-application-on-tomcat/