Using Sample Integration Tasks

iWay SDK provides sample integration tasks that can be used for building and deploying iIAs. The iWaySDKHome\build directory contains sample build scripts that support the following integration tasks:

The sample integration tasks must be executed by the build utility, which is located in the iWaySDKHome\build directory. You can review the list of these tasks by typing the following command in the command window:

build ABOUT

For more information on specific build task, type the following command:

build ABOUT <TASKNAME>

You can invoke the tasks by typing the following command in the command window:

build.cmd  TASKNAME CONFIGURATION <TARGETNAME>

where:

TASKNAME

Is the name of the build integration task.

CONFIGURATION

Is the build configuration located under iWaySDKHome\build\configurations.

TARGET

Is the optional name of the target properties file, which defaults to default.properties.

ABOUT

Describes help topics about a specified task.

A sample configuration called iway is packaged with the iWay SDK to demonstrate each of the sample integration tasks.

To begin, type the following command in the command window:

build BUILDAPP iway

This will execute the BUILDAPP task and build the iWay Integration Application (iIA) defined in the default target of the iway configuration. Configurations are located in the \build\configurations folder. For example, browse to the following file:

\build\configurations\iway\default.properties

The default.properties file contains a rich set of configuration properties that drive the build and deployment process. Documentation for these properties can be found by studying the comments found in this file or by typing the following command in the command window:

build ABOUT BUILDAPP

The following information is displayed:

This can be repeated for each of the TASKS of the build system. Moving forward, notice that after executing BUILDAPP using the iway configuration and default target, that the iWay SDK has created the following:

\build\configurations\iway\default\dist\mover.iia

The build assumes that the sources (iIT projects) defining iIAs are located in the following directory:

\build\projects\

Regardless whether the iIT project references a project from a different Eclipse workspace, all dependent iIT projects must be available in this directory.

To deploy mover.iia to an iSM server, enter the following:

build DEPLOYAPP iway

Endpoints, including authentication information (user ID and password), can once again be found in the property file for the target (for example, default.properties).

To start or stop the iIA, use the STARTAPP or STOPAPP integration tasks.


iWay Software