The Simple Messaging Framework

This document describes the Simple Messaging Framework installation process. It describes software requirements and the steps to install the framework from a binary distribution. If you wish to build the framework from a source distribution, please refer to Building SMFW.

We recommend that you store the Simple Messaging Framework and other required libraries under one library directory. This makes it easy to share the libraries among multiple projects. See the example below for a sample directory structure. Note however that this is only a recommendation; you may choose any directory structure based on your preference and needs.

lib
 +--ant-1.5.3-1
 +--ant-contrib-0.3
 +--axis-1.1
 +--carbon-2.0
 +--commons-logging-1.0.3
 +--httpclient-2.0-beta2
 +--jboss-3.0.4
 +--jdom-b8
 +--junit-3.8.1
 +--log4j-1.2.8
 +--servlet-2.3
 +--smfw-1.0
 +--tomcat-4.1.24
 +--xalan-j_2_5_D1
 +--xerces-2.4.0
 +--xpp3

The Simple Messaging Framework requires the following software and libraries. Make sure you have these packages installed before installing the framework.

• JDK version 1.4.2
• Ant version 1.5.3-1
• JUnit version 3.8.1
• Axis version 1.1
• Xerces version 2.4.0

Step 1: Download the Simple Messaging Framework binaries

Get the latest SMFW binaries archive from the project download page. Explode the archive to a directory on your local machine.

Step 2: Download required libraries

Get the archive of 3rd party libraries required by the framework. Explode this archive to a directory on your local machine.

Step 3: Copy ant-contrib.jar to Ant lib directory

Copy ant-contrib.jar from the ant-contrib library to ant-1.5.3-1/lib directory.

Step 4: Copy junit.jar to Ant lib directory

Copy junit.jar from the JUnit library to ant-1.5.3-1/lib directory.

At this point you can start using the framework in your applications. The framework jars are located in the smfw-1.0 directory. You may wish to test out your installation using the demo applications supplied with the framework.