Installing Tomcat
Instructions on how to install Tomcat
- Download and unpack.
- 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.
- Type "ant", which will download all the required files (way over 100 Mb so do with decent broadband).
- 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.
- 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".
- 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).
- 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.
- 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.