Trail: PROIV Documentation > Developer > Active Web > Packaging an Active Web Application

Base Package

When Active Web 4 is deployed as either the default web application of the bundled application server or as a WAR file which has to be deployed manually.  In both cases the end result is a file system directory structure in which you build the web application.

The web application file system structure by default will contain the following directories:

The Active Web and its configuration reside in the WEB-INF directory.  Any application files and directories sit at the same level as the Active Web directories.  The default Active Web configuration maps the Active Web servlet to the patterns /concertox/* and *.xsp, the servlet log files are configured to be written the Web Application temporary directory.

Extending the Base Package to include your application

In order to extend the extracted Active Web WAR file to include your Active Web application you will need to download and install a Java Development Kit (JDK).  We recommend the Java 7 that includes a command line utility (jar) which can be used to extract the contents of a WAR file.

The procedure for packaging your Active Web application and its static content with the base package is straight forward.  First you should familiarize yourself with the user documentation for the jar utility included in your JDK; then follow the process outlined below:

  1. Go to the root directory of your developed web application.  In the case of the bundled server this would be the webapps/root directory of the installation.  In the case of default deployment options in Tomcat it would be the webapp/concerto directory of your Tomcat installation.

  2. Rebuild the war file using the jar command with the cf option: Substitute your archive name in the command below.

    jar cvf <new_archive> *.*

The end result will be a war file with the original base Active Web package combined with your Active Web application.

Remember that if you have security setup on the Active Web installation then that configuration information will also be added to the archive; this means you will need to setup the relevant security information on any server you choose to deploy the archive.

You should not remove any of the files or directories underneath the WEB-INF directory as they contain the Active Web and its configuration.

Related Topics:

Active Web as a Web Application

Building a Web Application WAR File

Comment on this topic

Topic ID: 150030