03 - Spring Environment Set Up: Page 2 of 3


3.3 Apache Tomcat web server.

We would need a stable and open source web server that we can use to develop and run Spring Framework based applications. There are several options available but in this tutorial we will use Apache Tomcat.

Tomcat is actually composed of a number of components and containers including a Tomcat JSP engine, servlet Container and a variety of different connectors, but its core component is called Catalina. One important thing to be noted is Tomcat is a web server and not an application server.

Tomcat is  freely available and can be downloaded from http://tomcat.apache.org/download-70.cgi

Note There are several versions of tomcat and java are available so make sure you download compatible versions.

Steps to download and configure Tomcat

  1. Once tomcat web server is downloaded, unzip it to the location of your choice. I use the top level of the D drive, resulting in D:\apache-tomcat-7.0.41 . By default tomcat is configured to run on port 8080 so it will be accessed by http://localhost:8080

Tomcat Download Screen - 1

  1. Create a new environment variable CATALINA_HOME and set its value to the apache tomcat installation directory. In my case it will be D:\apache-tomcat-7.0.41
  2. To start and stop the server, you need to use the batch files available in %CATALINA_HOME%/bin

Tomcat Download scree - 2

  • startup.bat to start the server
  • shutdown.bat to stop the server

If you hit an error while starting server a saying “java_home /jre_home” is not set means you have not configured JAVA_HOME as described in section 3.2


Start the server using D:\apache-tomcat-7.0.41/bin/startup.bat and hit http://localhost:8080 in the browser. You should see page like below.

Apache Tomcat screen

3.4 Eclipse - Integrated Development Environment

We can write java programs using any text editor but  several IDE are freely available. I would encourage use of IDE because IDE provides us several features like -

  1. we can manage the Tomcat,
  2.  develop programs and web application
  3. need not to remember the exact methods and their signatures
  4. compilation errors are clearly highlighted

There are several IDEs available like NetBeans, Eclipse etc. We will use Eclipse in this tutorial.

Download the latest eclipse version (Eclipse Kepler) from http://www.eclipse.org/downloads/packages/release/Kepler/SR2 and unzip it in directory of your choice . You need to download Eclipse IDE for Java EE Developers and not Eclipse Standard

I normally unzip into the top level of the D drive, resulting in D:\ eclipse-standard-kepler-SR2-win64

Start EclipseStart eclipse by clicking eclipse.exe available in eclipse installation directory.

Eclipse Installation Directory Image

Once eclipse starts it will ask for a workspace. You can create one folder of your own choice and give the path of that folder. Workspace is basically a folder where eclipse will create all of your projects.

 3.5 Tomcat Integration with Eclipse

As I mentioned earlier, tomcat can be managed with eclipse IDE and in this section we will discuss how to integrate tomcat with eclipse.

To do so

  1. Go to Windows àPreferencesàServersàRuntime Environments àAdd in eclipse.
  2. On click of Add , a new window will be opened (refer below). From the list of Tomcat servers, select “Apache Tomcat v7.0” and click Next

Tomcat Apache integration screen

  1. Select the path of Tomcat installation directory

Tomcat Apache integration screen -2

Start and Stop Tomcat server from Eclipse

Click on Servers tab at bottom. Click on Green Arrow icon to start the server and Red square icon to stop.

Starting and Stopping of Tomcat Server

Server console log can be seen in eclipse console. Once server is started, verify it by hitting http://localhost:8080 in browser.

Like us on Facebook