Installing Apache Tomcat on Ubuntu 9.04 (Jaunty)
Updated by Linode Written by Linode
DeprecatedThis guide has been deprecated and is no longer being maintained.
Apache Tomcat is an “open source software implementation of the Java Servlet and JavaServer Pages technologies.” You may choose to use either the OpenJDK implementation or the Sun Microsystems implementation of Java when installing Tomcat.
Before beginning this guide we assume that you’ve completed the getting started guide. If you are new to Linux server administration, we recommend considering the beginner’s guide, and the article concerning systems administration basics. We also assume you’re logged into your Linode via SSH as root for this guide.
Choose and Install Java Implementation
Make sure your package repositories and installed programs are up to date by issuing the following commands:
apt-get update
apt-get upgrade --show-upgraded
You must choose which implementation of the java language you wish to use. Note that there is some variance in the implementations of the Java language, and you should install a version that is compatible with the application that you are hoping to run and/or write.
If you choose to run OpenJDK, you can skip the rest of this section, as OpenJDK will be installed as a dependency when you install the tomcat6 package; OpenJDK is pulled in by the “default-java” meta package in Ubuntu.
If you would like to run the Sun Microsystems implementation of Java you must first edit the /etc/apt/sources.list
file and append two package repository sources. Sun’s licensing terms are considered “non-free” under the guidelines that govern inclusion in Ubuntu’s “main” software repositories.
Add the following two lines to your sources.list
list:
- /etc/apt/sources.list
-
1 2
deb http://us.archive.ubuntu.com/ubuntu/ jaunty multiverse deb-src http://us.archive.ubuntu.com/ubuntu/ jaunty multiverse
Update apt to get the necessary package lists:
apt-get update
Now you are ready to install Sun Java with the following command (acknowledging the license terms):
apt-get install sun-java6-jdk
Now you are ready to proceed with the Apache Tomcat install.
Installing Apache Tomcat
To install Tomcat, issue the following command:
apt-get install tomcat6
You may also want to install the tomcat6-docs
, tomcat6-examples
, and tomcat6-admin
tools which provide web-based applications that document, test, and allow you to administer Tomcat. You can install all three with the following command:
apt-get install tomcat6-docs tomcat6-examples tomcat6-admin
Tomcat should now be totally functional and should start automatically with the system. If you need to start, stop, or restart Tomcat you can use the following commands:
/etc/init.d/tomcat6 start
/etc/init.d/tomcat6 stop
/etc/init.d/tomcat6 restart
Test and Use Tomcat
You can test your Tomcat installation by pointing your browser at http://[yourdomain-or-ip-address]:8080/
. By default, files are located in the /usr/share/tomcat6
directory. To configure the admin area, you’ll need to add the following lines to the end of your tomcat-users.xml
file (replacing “s3cret” with a more appropriate password):
- /etc/tomcat6/tomcat-users.xml
-
1 2
<role rolename="manager"/> <user username="tomcat" password="s3cret" roles="manager"/>
Congratulations! You know have a working Apache Tomcat installation.
More Information
You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.
Join our Community
Find answers, ask questions, and help others.
This guide is published under a CC BY-ND 4.0 license.