
	News \| FAQs \| Contacts

WebMap Composer Product Home

	Requirements
	Install Note
	Release Note
	Configuration

WAR File / Tomcat Deployment Options

Web Map Composer (WMC) may be installed several ways, depending upon your server infrastructure architecture:

War file installed under $TOMCAT_HOME/webapps/ directory

Source files (unzipped or from CVS or from a war file) installed under $TOMCAT_HOME/webapps/ directory.

Source files (unzipped or from CVS or from a war file) installed on server and a tomcat context definition set up.

You may receive an application (ie. package of jsp, html, xml and xsl pages) in one of the following formats.

WAR file

Tarred/zipped file (*.tar.gz)

Directly checked out from CVS

Before you install

Before you perform the installation ensure you have the following information:

Know where the directory location of your Tomcat install is. [It will now be referred to as: $TOMCAT_HOME ]

WAR file install

The following steps need to be followed in order to successfully install the application as a .WAR file. Whatever the war file name is, this will become the name of the top directory once unzipped and run as an application.

Ie. wmc.war would be run in a browser as http://serverlocation:port/wmc.

1. Stop tomcat.

2. Go to the following directory: $TOMCAT_HOME/webapps/

3. Copy the file [application_name].war to this directory

4. You may do one of two things next (both have the same outcome although the first only requires you to restart tomcat once). Removing the war file once it has been unzipped will prevent it being unzipped again and potentially overwriting any file you may have changed.

a) Requires only one start of tomcat.

Unzip the file using the following command: jar -xvf [application_name].war.

Delete the .war file or copy elsewhere.

b) Requires more than one start of tomcat.

Start tomcat (tomcat automatically will unzip the war).

Stop tomcat

Delete the .war file or copy elsewhere.

5. Start Tomcat

6. Test the application by going to http://urllocation:port/name_of_war.

Ie. http://urllocation:port/wmc.

NOTE: Any changes made to anything under the file $TOMCAT_HOME/webapps/[warfilename]/WEB-INF directory requires that Tomcat be restarted to pick up the changes.

Tarred/zip file or checked out from CVS

The following steps need to be followed in order to successfully install the *.tar.gz or CVS source files under tomcat. It assume that the *.tar.gz has been unzipped somewhere or that you have the ability to checkout out an application from CVS.

There are two alternative ways to install the source application files under tomcat.

a) Install under the $TOMCAT_HOME/webapps directory

This method is similar to if you were to place a war file in the $TOMCAT_HOME/webapps directory (see 2.3).

1. Stop tomcat.

2. Copy the unzipped application files or check them out from CVS in to the $TOMCAT_HOME/webapps/ directory.

Ie. You may have unzipped the application so that the top directory name is wmc, or checked the application out of CVS naming the top directory as wmc

3. The top directory of the application (which now sits in the webapps directory), should contain the WEB-INF directory.

4. Start tomcat.

5. Test the application by going to http://urllocation:port/name_of_application_dir.

Ie. http://urllocation:port/wmc.

b) Install under tomcat by defining a context

This method allows the application installer to place the application anywhere on the server and tell tomcat where to find it by using a manually defined context name, therefore not restricting the user to having to place it under the $TOMCAT_HOME/webapps/ directory.

1) Stop tomcat.

2) Place your application wherever you like on your server (having unzipped or checked it out from CVS).

3) Open the $TOMCAT_HOME/conf/server.xml for editing.

In it you will find a reference to.

Copy this and edit it so that it looks similar to the following format.

This tells tomcat to create a context called 'wmc' and tell it to use the application located at /where/you/put/your/application/top_dir/ on your server. The WEB-INF directory need to be located just beneath this location.

NB. Make sure the <Context> tag you just defined isn't nested inside another <Context> tag. Also make sure that your xml is valid.

4) Start Tomcat.

5) Check the application by going to http://urllocation:port/context_name.

Ie. http://urllocation:port/wmc.

view Support Documents by category