8/12/2014

HowToInstallandConfigureApacheTomcatonaDebianServer|DigitalOcean

Search the community

How To Install and Configure Apache Tomcat

on a Debian Server

MENU

AUTHOR: JUSTIN ELLINGWOOD PUBLISHED: JAN 7, 2014 UPDATED: MAY 30, 2014
SUBSCRIBE

TAGGED IN: MISCELLANEOUS, DEBIAN DIFFICULTY: BEGINNER

Introduction
Apache Tomcat is an application server that can be used to serve Java applications to web
users. It is an open implementation of the Java Servlet and JavaServer Pages specs that
were developed by Sun Microsystems.
If you develop Java applications, Tomcat is a quick and easy way to serve them in a full
server environment specifically designed for that purpose.
In this guide, we will install Tomcat and do some basic configuration on a Debian 7 VPS. To
complete this tutorial, you will have to have a normal user with sudo privileges. Follow this
guide to learn how to create users on a Debian system.

Install Apache Tomcat

In this guide, we will install Tomcat version 7 and its associated packages. Luckily, these are
included in the default Debian repositories.
To get the basic package, we can update our package source list and then install the main
package:

sudoaptgetupdate
sudoaptgetinstalltomcat7

This is all we need to do to get to the default Tomcat page. Our installation is not complete
yet, but you can take a look at the default Tomcat page by going to your IP address or
domain followed by

in your web browser:

:8080
https://www.digitalocean.com/community/tutorials/howtoinstallandconfigureapachetomcatonadebianserver

1/9

8/12/2014

HowToInstallandConfigureApacheTomcatonaDebianServer|DigitalOcean

domain followed by :8080 in your web browser:

your_domain_or_ip:8080

In order to take advantage of more of Tomcat's features, we will install some additional
Tomcat packages.
These will allow us to use a web interface to control Tomcat. It will install some
documentation and examples that we can also access through the web interface as well.

sudoaptgetinstalltomcat7admintomcat7examplestomcat7docs

Install Java Development Tools

In order to use Tomcat to develop Java applications on your server, you will need to
download and install a few things.
The first thing we need to do is install a compatible Java Development Kit. We can install
the one that Debian selected as default with the following command:
https://www.digitalocean.com/community/tutorials/howtoinstallandconfigureapachetomcatonadebianserver

2/9

8/12/2014

HowToInstallandConfigureApacheTomcatonaDebianServer|DigitalOcean

sudoaptgetinstalldefaultjdk

This will install openjdk6jdk which will work well in our environment.
The Tomcat documentation also suggests that you install Apache Ant, which is a build tool
for Java applications, and a version control system of some sort. We will choose git:

sudoaptgetinstallantgit

These will help you build your Java applications and keep the code organized.

Configure Tomcat Web Interface

Before we can begin using some of the features we installed, we need to configure our
server with a user and password. Tomcat does not do this by default for security reasons.
The configuration is very simple. We need to edit a file called tomcatusers.xml . Open it
with an editor like this:

sudonano/etc/tomcat7/tomcatusers.xml

Inside, you will find a heavily commented user configuration file. In fact, the only portions of
the file that are not comments are:

<tomcatusers>
</tomcatusers>

As you might expect, we need to define a user between these two lines. We will give this
user access to the web interfaces. We can define a user like this:

<tomcatusers>
<userusername="admin"password="password"roles="managergui,admingui"/>
</tomcatusers>

Choose whatever username and password you would like. This will provide you with login
credentials that allow you to access the management panels.

https://www.digitalocean.com/community/tutorials/howtoinstallandconfigureapachetomcatonadebianserver

3/9

8/12/2014

HowToInstallandConfigureApacheTomcatonaDebianServer|DigitalOcean

credentials that allow you to access the management panels.

Save and close the file when you are finished.
We should restart Tomcat in order to implement our changes:

sudoservicetomcat7restart

Test the Web Interface

Once you have installed Tomcat and configured the user login, you can access the main
page by going to your server IP address or domain name followed by :8080 like this:

your_domain_or_ip:8080

You will see the same default Tomcat page that you saw earlier (if you checked):

Because we have installed and configured more components, however, we will have access
to more functionality.
https://www.digitalocean.com/community/tutorials/howtoinstallandconfigureapachetomcatonadebianserver

4/9

8/12/2014

HowToInstallandConfigureApacheTomcatonaDebianServer|DigitalOcean

You can access the Tomcat documentation in the browser by clicking the link you see on
the page or accessing this page:

your_domain_or_ip:8080/docs

This should be your first stop when you have questions about how to do something with
Tomcat.
We also now have access to some example applications that are implemented using a few
different technologies. These can be reached from a link on the same initial landing page,
or by visiting:

your_domain_or_ip:8080/examples

https://www.digitalocean.com/community/tutorials/howtoinstallandconfigureapachetomcatonadebianserver

5/9

8/12/2014

HowToInstallandConfigureApacheTomcatonaDebianServer|DigitalOcean

Clicking through these items gives us an idea of how different functionality can be
implemented in this environment. Most examples include the source code that you can use
for reference.
The main functionalities that you will want access to are the manager webapp and the hostmanager webapp.
Again, you can access those from the initial landing page, or by visiting:

your_domain_or_ip:8080/manager/html

And:

your_domain_or_ip:8080/hostmanager/html

The first site will allow you to manage your Java applications. It will let you start, stop,
deploy, and reload your apps easily. It can also find memory leaks caused by your running
applications:

https://www.digitalocean.com/community/tutorials/howtoinstallandconfigureapachetomcatonadebianserver

6/9

8/12/2014

HowToInstallandConfigureApacheTomcatonaDebianServer|DigitalOcean

From the other page, you can test, adjust, and add virtual hosts in order to server your
applications. This allows you to set up access to your deployed apps easily:

Conclusion
As you can see, Tomcat provides a nice platform for controlling and serving your Java
applications in a web environment. You can easily deploy .war files and have them up and
running in very little time.
Tagged In: Miscellaneous, Debian

By Justin Ellingwood

Written By:
Justin Ellingwood

Do you find this post helpful?

Show the author by Hearting it!

https://www.digitalocean.com/community/tutorials/howtoinstallandconfigureapachetomcatonadebianserver

7/9