Agila (Computer Science Development Server), University of the Philippines Manila

Apache Tomcat is a web container that allows you to serve Java Servlets and JSP (Java Server Pages) web applications.

Main Tomcat Server

The main Tomcat server of agila could be accessed at http://agila.upm.edu.ph:8080. The main Tomcat server hosts the application systems that are for production use or in the final testing stages. For development purpose, users should use the private Tomcat instance in agila.

Private Tomcat Instance

With the private Tomcat instance it allows every agila user to run (without root rights) separate private instances of Tomcat while still using the system-installed libraries.

Requesting for Private Tomcat Instance

To request for a private tomcat instance, send an email to rbchua@upm.edu.ph with the following information:

  • Your full name
  • Your course and year level
  • Purpose for the account (e.g. the subject where this is needed and the nature of the activity)

How to Use Your Private Tomcat Instance

After your private Tomcat instance has been created, you should take note of the following:

  • The private instance directory which is located in your home directory. You should be informed by the administrator about the location of this directory. This directory is where your private Tomcat configuration files, starting/stopping scripts and applications are located.
  • Your Tomcat HTTP port. This is the port that you are going to use to access your private Tomcat instance. Your private Tomcat instance could be accessed at http://agila.upm.edu.ph:your-Tomcat-HTTP-port
  • Your Tomcat Control Port. This is the port that is used to control your private Tomcat instance (e.g. starting and stopping your Tomcat). Generally, you will not be using the control port.

Configuring your private instance

You will find the classic Tomcat configuration files for your private instance in the conf subdirectory of your private instance directory.

NOTE: You should not change the HTTP port and control port assigned to you which is specified in the conf/server.xml file in your private instance directory to avoid conflicting with other instances that might be running.

Starting/stopping your private instance

You can start your private instance by entering the following command in the terminal prompt (supposing your instance is located in the my-instance directory and your present directory is your home directory):

my-instance/bin/startup.sh

You should check the logs subdirectory (which is located in the private instance directory) for any error. If you have a java.net.BindException: Address already in use<null>:8080 error, it means that the port you're using is already taken and that you should change it.

You can stop your instance by entering the following command in the terminal prompt (supposing your instance is located in the my-instance directory and your present directory is your home directory):

my-instance/bin/shutdown.sh