Copyright © 2008, 2009, 2010, 2011, 2012 Lars Vogel
|Revision 0.2-1.1||09.04.2009 - 15.11.2012||Lars
|bug fixed and enhancements|
Table of Contents
Apache Tomcat is a webcontainer which allows to run servlet and JavaServer Pages based web applications. Most of the modern Java web frameworks are based on servlets and JavaServer Pages and can run on Apache Tomcat, e.g. JavaServer Faces, Struts, Spring.
Apache Tomcat also provides by default a HTTP connector on port 8080, e.g. Tomcat can also be used as HTTP server even though the performance of Tomcat is not as good as the performance of the Apache HTTP server.
For Ubuntu you can install Tomcat via the following commands.
apt-get install tomcat7 apt-get install tomcat7-admin apt-get install tomcat7-docs apt-get install tomcat7-examples
Download the Windows installer for Tomcat7 from the Apache Tomcat Homepage and run the installer.
In Ubuntu the Tomcat server is started automatically. To restart Tomcat use the following command.
# Restart sudo /etc/init.d/tomcat7 restart # Stop sudo /etc/init.d/tomcat7 stop
The default port for Tomcat is 8080. After starting Tomcat on your local you can validate if Tomcat is running the URL: http://localhost:8080.
Tomcat provides a webbased adminstration console which can be started via the following link.
The default user for the administration console of Tomcat is called admin with the admin password.
The available users can be found in the
directory of the Tomcat installation.
On Ubuntu the user for the administrator console is not created
you have to add the
user entry manually to the
. The following listing gives an example for a user. To get more
information try to login and see the resulting error message.
<role rolename="manager-gui" /> <user username="tomcat" password="s3cret" roles="manager-gui" />
The standard deployment format for webapplications is a
you have create a war application just put this application
folder. The next time tomcat starts it will unpack
and make the
Web applications may require external libraries. Typically web application contain there own libraries but if you want to make certain libraries available for all applications you can put them into the folder "lib" and a subfolder below "lib". These libraries are then available for all web applications.
After going through the setup you probably want to learn how to develop servlets and JSP on installation directory. Please see Servlets and JSP development - Tutorial
contains also a HTTP connector which can be used
to serve static HTML
pages. The standard directory which will be
served is below the
below the installation directory. Place static content
into this directory.
To allow directory browsing via Apache Tomcat change the
in the file
from false to true.
<servlet> <servlet-name>default</servlet-name> <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class> <init-param> <param-name>debug</param-name> <param-value>0</param-value> </init-param> <init-param> <param-name>listings</param-name> <param-value>true</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet>
This tutorial is Open Content under the CC BY-NC-SA 3.0 DE license. Source code in this tutorial is distributed under the Eclipse Public License. See the vogella License page for details on the terms of reuse.
Writing and updating these tutorials is a lot of work. If this free community service was helpful, you can support the cause by giving a tip as well as reporting typos and factual errors.
If you find errors in this tutorial, please notify me (see the top of the page). Please note that due to the high volume of feedback I receive, I cannot answer questions to your implementation. Ensure you have read the vogella FAQ as I don't respond to questions already answered there.
http://tomcat.apache.org/ Apache Tomcat Homepage
http://wiki.eclipse.org/WTP_Tomcat_FAQ Eclipse WTP and Tomcat FAQ
http://tomcat.apache.org/tomcat-6.0-doc/security-manager-howto.html Apache Tomcat Sercurity Manager How-to