Personal tools
You are here: Home Developers Corner Java API documentation Installing Tomcat
Document Actions

Installing Tomcat

by Wayne Boucher last modified 2008-03-10 20:24

Instructions on how to install Tomcat

  1. Download and unpack.
  2. Tomcat uses /usr/share/java to download third party code so if you don't have permission or don't want to put it there then you can specify a directory.  In the main Tomcat directory create a build.properties and in that set base.path to the directory of your choice, e.g.base.path=/Users/wb104/tomcat.
  3. Type "ant", which will download all the required files (way over 100 Mb so do with decent broadband).
  4. To use the WAR deployment facility you need to also download commons-io-X.Y.Z.jar (e.g. commons-io-1.3.1.jar) and put in build/build/common/lib.
  5. To make yourself a manager cd into build/build/conf and edit tomcat-users.xml and add a role with rolename="manager" and add a user with username and password whatever and roles="manager".
  6. To start up the server cd into build/build (and only this directory, otherwise compiling the Halx server will not work).  Then run bin/startup.sh (and to stop the server run bin/shutdown.sh).
  7. The default port is 8080.  The default applications are in build/build/webapps and the default home page is build/build/webapps/ROOT/index.jsp.  Go to http://localhost:8080 and click on Tomcat Manager.
  8. To deploy a WAR file use the deploy mechanism on the Manager page.  When things go wrong the error message on the Manager page is cryptic.  For a fuller message look in the log files in build/build/logs, e.g. catalina.out.


Powered by Plone, the Open Source Content Management System

This site conforms to the following standards: