From Wiki

Tomcat6 / Ubuntu 10.04 LTS

Alter listening port

#> vim /etc/tomcat/server.xml
   <Connector port="8088" protocol="HTTP/1.1" 
              redirectPort="8443" />

Add administrative user

#> vim /etc/tomcat6/tomcat-users.xml
<role rolename="manager-gui"/>
<role rolename="manager-script"/>
<role rolename="manager"/>
<role rolename="admin-gui"/>
<role rolename="admin-script"/>
<role rolename="admin"/>
<user username="tomcat" password="123-qwe" roles="manager-gui,admin-gui,manager,admin,manager-script,admin-script"/>


Administration interface

When running on port 8088 (! standard is 8080) e.g.:



  1. Put log4j-xx.jar to /var/lib/tomcat6/common/classes
  2. Put in /var/lib/tomcat6/common/lib

See Grails

Integration Tomcat6 / Eclipse

DO NOT DO THIS ON THE SERVER - only for testing on a local PC!!!


cd /usr/share/tomcat6
sudo ln -s /var/lib/tomcat6/conf conf
sudo ln -s /etc/tomcat6/policy.d/03catalina.policy conf/catalina.policy
sudo ln -s /var/log/tomcat6 log
sudo chmod -R 777 /usr/share/tomcat6/conf

sudo /etc/init.d/tomcat6 stop

In Eclipse, click on Window/Show View/Servers If there is a tomcat6 server in there, delete it. Create a new one by right clicking in that Servers view. If you were in the middle of developing an application, you should (if it asks) associate the application with tomcat6.

Configure Tomcat6

├── Catalina
│   └── localhost
│       ├── host-manager.xml
│       ├── manager.xml
│       └── ROOT.xml
├── context.xml
├── policy.d
│   ├── 01system.policy
│   ├── 02debian.policy
│   ├── 03catalina.policy
│   ├── 04webapps.policy
│   └── 50local.policy
├── server.xml
├── tomcat-users.xml
└── web.xml


<role rolename="admin"/>
<role rolename="admin-gui"/>
<role rolename="admin-script"/>
<role rolename="manager"/>
<role rolename="manager-gui"/>
<role rolename="manager-script"/>
<role rolename="manager-jmx"/>
<role rolename="manager-status"/>
<user username="username" password="mypass" roles="admin,admin-gui,admin-script,manager,manager-gui,manager-script,manager-jmx,manager-status"/>

Now you have acces to the tomcat management interface on http://yourdomain/manager/html . But, if you like to deploy applications within the root context you probably never won't use it for managing your tomcat!

Tomcat and PHP - mixed environment

Given scenario:


  • PHP application is deployed in the same directory (physically on the server) as the jsp application.
  • PHP application cannot be allocated using symlinks (apache's „Follow symlinks“)

Tomcat 6 worker

This will make a php page accessible under the ROOT directory of a tomcat installation under the following prerequesites:

  • The php application must be installed under this ROOT dir (no symlinks)
  • Usage of mod_jk
  • The GrailsApp is deployed within a ROOT context
vim /etc/libapache2-mod-jk/


NOTE: ajp13_worker is the default worker on ubuntu / debian

Apache virtual host

vim /etc/apache2/sites-available/demo_jk.conf

<VirtualHost IP:80>

  ServerName subdomain.domain.tld

  DocumentRoot "/var/lib/tomcat6/webapps/myapp/ROOT"

  JkMount /** demo_worker
  JkUnmount /myphpapp/** demo_worker

  # JK.conf
  Alias /myapp "/var/lib/tomcat6/webapps/myapp/ROOT"

  <Directory "/var/lib/tomcat6/webapps/myapp/ROOT">
       Options Indexes FollowSymLinks
       # This is for grails, use .jsp for java server pages
       AddHandler jakarta-servlet2 .gsp

  <Location "/myapp/WEB-INF">
       Deny from all

  <Location "/myapp/META-INF">
       Deny from all
  # Optional
  # SetEnvIf Request_URI \.php no-jk


The important line for your php application root is

JkUnmount /myphpapp/** demo_worker

A php installation (e.g. TYPO 3) has to be installed in /var/lib/tomcat6/webapps/myapp/ROOT/myphpapp and then accessible under http://yourdomain/myphpapp .

Root Context

Application Developer's Guide

Apache Tomcat Configuration Reference:

Deploying „myapp“ as ROOT:

1. Creating a virtual host in Tomcat:


 <Engine ...
 <Host ...
 <Host name="subdomain.domain.tld"  appBase="webapps/myapp"
            unpackWARs="true" autoDeploy="true"
            xmlValidation="false" xmlNamespaceAware="false">

2. Creating a new ROOT directory

mkdir /var/lib/tomcat6/webapps/${MYAPP}/

This is the place where the ROOT.war file will be placed for deploying the wepapp.

3. Creating a new ROOT.xml and directory for the tomcat virtual host

mkdir -p /etc/tomcat6/conf/Catalina/${MYAPP}/ROOT.xml
vim /etc/tomcat6/conf/Catalina/${MYAPP}/ROOT.xml

<Context path="/" 
        antiResourceLocking="false" />

Deploy the app "ROOT.war" to it

/var/lib/tomcat6# tree -L 4
├── common
│   └── classes
├── conf -> /etc/tomcat6
├── logs -> ../../log/tomcat6
├── server
│   └── classes
├── shared
│   └── classes
├── webapps
│   └── myapp
│       ├── ROOT
│       │   ├── css
│       │   ├── home
│       │   ├── images
│       │   ├── js
│       │   ├── META-INF
│       │   ├── plugins
│       │   └── WEB-INF
│       └── ROOT.war
└── work -> ../../cache/tomcat6

Instead of -Dgrails.env=myEnv for a custom environment you can use the common grails environments dev, test or prod.

The created war MUST be named ROOT.war. In most cases you will configure a special environment for the deployment ( e.g. -Dgrails.env) when creating the war file. Definitions for the named environment in Config.groovy or DataSource.groovy (or at other places) are the same as for the standard environments test, development or producton.

grails -Dgrails.env=myEnv war ROOT.war

Save an existing php app (!) and remove the old version of your app on the server

ssh myserver "mv /var/lib/tomcat6/webapps/myapp/ROOT/myphpapp /var/lib/tomcat6/webapps/myapp/."
ssh myserver "rm -rf /var/lib/tomcat6/webapps/myapp/ROOT*"

Deploy it and restart the server, so it will be rolled out:

scp ROOT.war myserver:/var/lib/tomcat6/webapps/myapp/.
ssh myserver "service tomcat6 restart"
ssh myserver "mkdir /var/lib/tomcat6/webapps/myapp/ROOT"
ssh myserver "chown -R tomcat6:tomcat6 /var/lib/tomcat6/webapps/myapp/ROOT"
ssh myserver "mv /var/lib/tomcat6/webapps/myapp/myphpapp var/lib/tomcat6/webapps/myapp/ROOT/."
ssh myserver "service apache2 restart"

For production environment I would script this on the server and do a backup (zip with timestamp) of the ROOT directory first.

Restart tomcat and apache

Always restart tomcat6 first and then apache2.

Now both apps should be up and running.

mod_proxy and mod_ajp

Go up to mod_jk above and configure your apache virtual host. mod_ajp doesn't work for unknown reasons yet! Also working with mod_proxy as described in the following part might be tricky with some applications

[[Image:]] Mod_ajp

Creating a virtual host with mod_proxy (http) in apache2:

apt-get install libapache2-mod-proxy-html

Deploy via Tomcat-Manager

Context Path (required): /myapp    
XML Configuration file URL:  myapp/ROOT.xml
WAR or Directory URL: /where/ever/on/server/ROOT.war

<VirtualHost *:80>

  ServerName subdomain.domain.tld
  # a2enmod proxy_http
  # Security:
  ProxyRequests Off
  <Proxy *>
    AddDefaultCharset off
    Order deny,allow
    Allow from .domain.tld

  <Location />
        ProxyPass http://subdomain.domain.tld:8080/
        ProxyPassReverse http://subdomain.domain.tld:8080/


[[Image:]] The Role of a context.xml in the META-INF direcotory of your app

vim web-app/META-INF/context.xml