The iWay SDK is packaged with the sample configuration called iway, which contains two targets:

• default. Configured for building WAR files for application servers using the web.xml 1.4 specification.
• WASCE. Configured for building WAR files for IBM WebSphere Application Server Community Edition (WASCE).

If you look at each of these targets, you will notice that there exists one or more deployment descriptors in the following directory:

\build\configuration\target_name\war\WEB-INF

For most application servers, a single descriptor file (web.xml) is required. For WASCE however, an additional file called geronimo web.xml is required. Consult the documentation for the application server for its descriptor format and requirements.

To demonstrate WAR creation, enter:

build BUILDWAR iway

or

build BUILDWAR iway WASCE

A mover_dev.war file will appear in the \build\configuration\target_name\dist directory. This file can now be deployed into an application server. For more information on deploying WAR files, see the documentation for the application server.

Once deployed, invoking the application will display the ISM console license page indicating that the application is not authorized to run within an application server container. The iWay SDK is not packaged with a license file with this functionality enabled. There are two workarounds. The first is to request a license file for the SDK with this feature enabled from an iWay Software Customer Support representative.

With a new license file in hand, copy the file into the root directory of the SDK. Then, in the target configuration file (for example, \build\configuration\target_name.properties), uncomment the following property:

update.license

This will now insert the new license file into the WAR file. Redeploy the WAR file and the application will be authorized for servlet functionality.

Another method of adverting the license issue is to override the default WAR source file. By default, the iWay SDK uses the following WAR file as its base for iSM server components:

\etc\setup\ismbase.war

WAR files generated by iSM servers authorized for servlet deployment will contain the proper licensing, which can be used accordingly. To override the iWay SDK default WAR file, refer back to the configuration of the target and set the following property accordingly:

warsource.war=c:\\customwar.war

Providing customwar.war is authorized to run in an application server. Any WAR file generated through BUILDWAR using this target will also do the same.