Apache Tomcat on Ubuntu 10.10 (Maverick)
Updated by Linode
This guide has been deprecated and is no longer being maintained.
Apache Tomcat is an open source software implementation of the Java Servlet and Java Server Pages technologies. You may choose to run applications within Tomcat using either the OpenJDK implementation or the Sun Microsystems/Oracle implementation of the Java development environment.
Before following this guide, ensure that your system is up to date and that you have completed the getting started guide. If you are new to Linux server administration, we recommend reviewing our beginner’s guide and the article concerning systems administration basics.
Set the Hostname
Before you begin installing and configuring the components described in this guide, please make sure you’ve followed our instructions for setting your hostname. Issue the following commands to make sure it is set properly:
hostname hostname -f
The first command should show your short hostname, and the second should show your fully qualified domain name (FQDN).
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
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/Oracle implementation of Java, edit the
/etc/apt/sources.list so that it resembles the following example. This will enable access to the “partner” repository:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29
## main & restricted repositories deb http://us.archive.ubuntu.com/ubuntu/ maverick main restricted deb-src http://us.archive.ubuntu.com/ubuntu/ maverick main restricted deb http://security.ubuntu.com/ubuntu maverick-updates main restricted deb-src http://security.ubuntu.com/ubuntu maverick-updates main restricted deb http://security.ubuntu.com/ubuntu maverick-security main restricted deb-src http://security.ubuntu.com/ubuntu maverick-security main restricted ## universe repositories - uncomment to enable deb http://us.archive.ubuntu.com/ubuntu/ maverick universe deb-src http://us.archive.ubuntu.com/ubuntu/ maverick universe deb http://us.archive.ubuntu.com/ubuntu/ maverick-updates universe deb-src http://us.archive.ubuntu.com/ubuntu/ maverick-updates universe deb http://security.ubuntu.com/ubuntu maverick-security universe deb-src http://security.ubuntu.com/ubuntu maverick-security universe ## partner repositories deb http://archive.canonical.com/ubuntu maverick partner deb-src http://archive.canonical.com/ubuntu maverick partner deb http://archive.canonical.com/ubuntu maverick-updates partner deb-src http://archive.canonical.com/ubuntu maverick-updates partner deb http://archive.canonical.com/ubuntu maverick-security partner deb-src http://archive.canonical.com/ubuntu maverick-security partner
Issue the following command to update your system’s package repositories:
Now you are ready to install Sun Java with the following command (after agreeing to the license terms):
apt-get install sun-java6-jdk
Install Apache Tomcat
To install Tomcat, issue the following command:
apt-get install tomcat6
You may also want to install the
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 following installation and your next system reboot. If you need to start, stop, or restart Tomcat you can use the following commands:
1 2 3
/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, substituting your own username and password. Make sure you keep the “manager” role.
<role rolename="manager"/> <user username="username" password="examplemorris" roles="manager"/>
Issue the following command to restart the Tomcat server, which will allow this change to take effect:
Congratulations! You know have a working Apache Tomcat installation.
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.
This guide is published under a CC BY-ND 4.0 license.