Skip to main content
Jump to: navigation, search

Building I-Card Manager Application

Revision as of 03:43, 28 March 2007 by (Talk | contribs) ('''Exporting I-Card Manager application as a Web Archive (WAR) file''')

Asant and Ant

We use script asant, which is located in the J2EE 1.4 SDK bin directory, to build the source code of this application. asant is a wrapper around Ant which is a Java-based build tool like make, which has been developed under the auspices of the Apache Software Foundation. Ant version 1.5.3 and 1.6 beta 1 may also be used to build and deploy the applications.

Note: The I-Card Manager application bundle comes with pre-built binaries. To deploy these binaries and avoid building the application, consult the I-Card Manager installation instructions.

Exporting I-Card Manager application as a Web Archive (WAR) file

A Web archive (WAR) file is a packaged Web application that can be exported to test, publish, and deploy the resources developed within a Web project.

To export a WAR file from a Web project, do the following:

  • Right click on a Web project folder and select Export from the pop-up menu. Then select WAR file in the Export window and then select Next.
  • Specify the Web project you want to export (this field is primed if you used the pop-up menu to open the wizard), and specify a location for the new WAR file
  • Optional: Optionally, supply WAR export Options, such as whether or not to include Java™ source files in the WAR, and whether to overwrite any existing resources during the export process. Source files are not usually included in a WAR file, because they are not necessary for the server to run the web application.
  • Click Finish.

Build I-Card Manager application

This section explains how to build the application binaries for the I-Card Manager application. Building all the application binaries and performing other tasks with Ant involves invoking asant from <higgins_broker.home>/apps/icard directory of the Higgins Broker installation.

Before building the application, you need to configure the <higgins_broker.home>/ file to match your enviroment. You need to set the following properties:

Property Name Description Examples
j2ee.home The absolute path to the directory where J2EE SDK is installed. c:\j2sdkee1.4 (on Windows) or /home/mydir/j2sdkee1.4 (on Unix)

Note: On Windows, while writing the paths in the files, you need to escape the "\" properly by using "\\" instead. For example, to set j2ee.home to c:\j2sdkee1.4, the entry in the properties file is j2ee.home=c:\\j2sdkee1.4.

To build the application binaries on Unix, open a shell prompt and enter these commands:

cd <higgins_broker.home>/apps/icard
asant [argument]

To build the application binaries on Windows, open a shell prompt and enter these commands:

cd <higgins_broker.home>\apps\icard
asant [argument]

For the above command to work, your PATH environment variable must have been set as explained in the I-Card Manager installation instructions and the ANT_HOME environment variable, if any, should not point to any other version of ant that migh be on your system. When asant is invoked without any arguments, all the application binaries are built. The binaries are placed in the following folders:


The following table lists possible arguments when invoking asant :

Option Purpose
core Builds everything. (This is the default build target.)
clean Cleans out the build output directories.
deploy-apps Deploys the application binaries.

Back to the top