Installing and Configuring Tomcat

A quick guide to getting things set up on Windows

Setup Environment
I will assume everyone will be using Windows. Also make sure you have the Java SDK installed on your PC.
The SDK includes the java compiler and some other tools as well as the runtime environment. You need the compiler to run tomcat.

Installing Tomcat
Go to the Jakarta binaries web site:
http://jakarta.apache.org/site/binindex.cgi

Click the link for 5.0.19.zip.

Right click and save to your desktop

Save to Desktop and Extract

You should have jakarta-tomcat5.0.19.zip as a zip icon on your desktop. Right click and choose Extract All. This will create a jakarta-tomcat-5.0.19 folder also on your desktop.

Running Tomcat
In the Tomcat folder, open the bin folder. Click the startup.bat icon. You should see a black and white Java command window.
You should not see any obvious java error messages.

Open your browser and point to http://localhost:8080.

You should see the Tomcat welcome page.

Note startup.bat actually calls other scripts in the same directory (catalina.bat, particularly). The .sh files are for running Tomcat on Linux/Unix
Maybe Mac also.

Run Some Examples

From Tomcats welcome page, click the examples link and run some examples to make sure everything is OK.

Problems
Tomcat failures to start correctly if
you either do not have the Java SDK installed on, or your JAVA_HOME environment variable is set incorrectly.

You must have the Java SDK installed, since you need javac.

Setting JAVA_HOME on Windows XP

From Start at the bottom left of your screen, open the control panel. Select System to edit System properties and choose the Advanced tab. Click the Environment Variables Button. Edit or add the JAVA_HOME variable
It should point to the top folder of your Java installation. C:\j2sdk1.4.1_02, for example. Check My Computer to get the actual name.

Shutting Down Tomcat

You can do this in at least two ways:
By closing the black and white java command window. By executing shutdown.bat in Tomcats bin directory
Same place as startup.bat.

Running shutdown.sh is probably best.

Running Two Tomcat Servers

Web services often are applied to allow two Tomcat (or other) servers communicate
One does display, the other runs commands.

So to really test things out and to understand what is going on, you should set up and run two web servers.
Preferably on two different machines.

Installing a second server on the same host follows all of the same steps as before, with one additional step.
You must modify server.xml

Finding server.xml
The file server.xml has all of the server configuration information. This is located in the folder jakarta-tomcat-5.0.19/conf. You only need to edit it in two places.
See next slide

Double click it to open it with your favorite text editor. Make a backup copy of server.xml before you change things.

Tomcat Ports
Tomcat 5s default settings listen to three ports: 8080, 8005, 8009.
8080 is the http port number. 8005 is the shutdown port.
You can contact this to shutdown Tomcat from another process.

8009 is the AJP port for running Tomcat behind an Apache server.
Not needed here, but port opened

Tomcat can use other ports

8443 for SSL connections
Commented out by default. Requires some additional configuration Redirecting HTTP to other servers. Commented out by default.

8082 is for proxy connections You dont have to edit these.

For reference, use 9090, 9005, and 9009.

Changing Ports
Only one server at a time can accept connections on ports 8080, 8005, and 8009. If you want run a second Tomcat server, you must change the values of these ports for the second server. Just edit server.xml to change these ports.
Shutdown the server first. Values dont matter For Linux/Unix, values <1024 are owned by root processes so you normally cant use these values.

Now restart the server. Point your browser at the new port number to check.
http://localhost:9090 for example.

Editing server.xml
The following slides show the config settings that you need to change the shutdown, http, and ajp ports. You can freely change other parameters if you want. Note of course you are taking advantage of your basic XML knowledge.

Shutdown port
<!-- A "Server" is a singleton element that represents the entire JVM, which may contain one or more "Service" instances. The Server listens for a shutdown command on the indicated port. Note: A "Server" is not itself a "Container", so you may not define subcomponents such as "Valves" or "Loggers" at this level. --> <Server port="9005" shutdown="SHUTDOWN" debug="0">

HTTP Connector
<!-- Define a non-SSL Coyote HTTP/1.1 Connector on port 8080 --> <Connector port="9090" maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false" redirectPort="8443" acceptCount="100" debug="0" connectionTimeout="20000" disableUploadTimeout="true" /> <!-- Note : To disable connection timeouts, set connectionTimeout value to 0 -->

AJP Port
<!-- Define a Coyote/JK2 AJP 1.3 Connector on port 8009 --> <Connector port="9009" enableLookups="false" redirectPort="8443" debug="0" protocol="AJP/1.3" />