Working With Applications

In this section:

Creating an Application From an Integration Project

How to:

The first step in the configuration process is to create an iWay Integration Application (iIA) that contains the components of the application you are developing.

Procedure: How to Create an Application From an Integration Project

To create an application from an Integration Project.

  1. Ensure that you already have an Integration Project created in iIT.
  2. Right-click the Applications folder under your Integration Project, select New, and then click Application from the context menu.


    The New Application Wizard opens, as shown in the following image.

  3. Enter a name for the application and a brief description, and then click Next.

    The Resource Selection pane opens, as shown in the following image.



  4. Select the required channels, transform components, and process flows that you want to add to your application.
  5. Click Next.

    The Process Business Services pane opens, as shown in the following image.



  6. Select application process flows to be deployed as business services.

    Note: To use web services, your application must include a SOAP channel.

  7. Click Next.

    The Included libraries pane opens, as shown in the following image.



  8. Select libraries (.jar, .zip, and .dll) to be added to the application (for example, database drivers) according to your requirements. These library files will be copied to the lib directory of the application during deployment.
  9. Click Next.

    The Included Resources pane opens, as shown in the following image.



  10. Select register files and folders to be added to the application according to your requirements. These files will be copied to the resource directory of the application during deployment.
  11. Click Next.

    The Bindings pane opens, as shown in the following image.



  12. Specify the application bindings (for example, Special Registers and Providers) to be resolved during deployment.
  13. Click Finish.

    The new application (for example, SampleApp) is added to the Applications folder of your Integration Project.



  14. Run build.xml in order to compile, build, and deploy your application on the server.

Creating an Application From the Administration Console

How to:

You can create an application from the iWay Service Manager Administration console.

Procedure: How to Create an Application From the Administration Console

To create an application from the administration console:

  1. Click the Management link in the iSM Administration Console.


  2. Click Applications in the left pane.

    The Application pane opens, as shown in the following image.

  3. Click New.

    The New Application pane opens, as shown in the following image.



  4. Enter a name for the application and a brief description, and then click Next.

    The Add Channels pane opens, as shown in the following image.



  5. Select the required channels that you want to add to your application.
  6. Click Next.

    The Add Processes pane opens, as shown in the following image.



  7. Select the required processes that you want to add to your application.
  8. Click Next.

    The Add Transforms pane opens, as shown in the following image.



  9. Select the required transform components that you want to add to your application.
  10. Click Next.

    The Add Libraries pane opens, as shown in the following image.



  11. Select any required libraries to be added to your new application.
  12. Click Finish.

    The new application (for example, SampleApp) is added to the Applications pane, as shown in the following image.



Importing

How to:

You can import an existing application into your environment if required.

Procedure: How to Import an Application

To import an application:

  1. Click the Management link in the iSM Administration Console.


  2. Click Applications in the left pane.

    The Application pane opens, as shown in the following image.



  3. Click Import.

    The Applications - Upload pane opens, as shown in the following image.



  4. In the Select an application to upload field, enter the path to an existing iWay Integration Application (.iia) file that you want to import. You can also click Browse to navigate to the file on your file system
  5. Click Finish.

    The imported application (for example, car) is added to the Applications pane, as shown in the following image.



Viewing

How to:

Viewing an application allows you to view build information, associated components, and bindings for the iWay Integration Application.

Procedure: How to View an Application

To view an application:

  1. Click the Management link in the iSM Administration Console.


  2. Click Applications in the left pane.

    The Application pane opens, as shown in the following image.



  3. Click the View icon in the Actions column.

    The following Applications pane opens, which includes a table with three tabs (General, Components, and Bindings).



    The General tab is selected by default and provides build information for the application.

  4. Click the Components tab.


    The Components tab lists the various iSM components (for example, channels and processes) that are used by the application.

  5. Click the Bindings tab.


    The Bindings tab lists the various iSM bindings (for example, registers and providers) that are used by the application.

Deploying

How to:

This section describes how to deploy an application.

Procedure: How to Deploy an Application

To deploy an application:

  1. Click the Management link in the iSM Administration Console.


  2. Click Applications in the left pane.

    The Application pane opens, as shown in the following image.



  3. Click the Deploy icon in the Actions column.

    The Deployments pane opens, as shown in the following image.



    The following table lists and describes the deployment properties.

    Property

    Description

    Deployment Name

    Use an auto-generated name or provide a custom name for the deployment.

    Deploy As Test Server

    Selecting this option makes the deployment available as a server where you can test run your components.

    Configuration Template

    If templates are configured, then you can select the template to use for the deployment. If no templates are available, then a 'raw' template is used by default.

    Application Description

    You can specify a short description for the deployment.

  4. After you have finished providing values for the required parameters, click Deploy.

    The application (for example, car_test) is added to the following Deployments pane, which allows you to manage your deployed application.



    The icons in the Actions column allow you to view, redeploy, and remove the deployment.

  5. To start the deployment, click the red circle icon in the State column.

    The following confirmation message is displayed.



  6. Click OK.

    A green circle icon with a check mark symbol in the State column indicates that the deployment is started.



  7. To stop the deployment, click the green circle icon with a check mark symbol in the State column.

    The following confirmation message is displayed.



  8. Click OK.

    Note: You can deploy your application from iIT using the build.xml script.

Downloading

How to:

This section describes how to download an application to your file system.

Procedure: How to Download an Application

To download an application to your file system:

  1. Click the Management link in the iSM Administration Console.


  2. Click Applications in the left pane.

    The Application pane opens, as shown in the following image.



  3. Click the Download icon in the Actions column.

    The File Download dialog opens, as shown in the following image.



  4. Click Save.

    The Save As dialog opens, as shown in the following image.



  5. Enter a name in the File name field for the application or accept the default value.
  6. Ensure that the .iia extension is used.
  7. Click Save.

Viewing Version History

How to:

Version history for applications is supported on the iSM console.

Procedure: How to View Version History

To view version history:

  1. Click the Management link in the iSM Administration Console.


  2. Click Applications in the left pane.

    The Application pane opens, as shown in the following image.



  3. Click the Versions icon in the Actions column.

    The Applications Versions dialog opens, as shown in the following image.



    You can view, deploy, download, and remove any existing version of the application.

Monitoring Events

How to:

iWay Integration Application (iIA) event trails enable you to monitor all of the events associated with iIAs. The information provided includes not only the action taken on a specific application, but also the user ID, time, and location, if appropriate. This enables complete monitoring of all applications associated with the server.

Procedure: How to Monitor Events

To monitor events:

  1. Ensure that your application has been deployed and the server is started.
  2. From the iSM Administration Console, select a deployed application from the Management drop-down list, as shown in the following image.
  3. Select Events from the Application Management category on the left pane of the console, as shown in the following image.

    The Events pane is displayed, as shown in the following image.

    The following table lists and describes all of the event monitoring information that is available for review in the Events pane.

    Column

    Description

    Source

    The specific application component for which an event has occurred.

    Operation

    The specific operation that has been performed on the component or has occurred. For example, delete, stop, start, deploy, and so on.

    Details

    A brief description of the event.

    Location

    The location of the event if applicable.

    User

    The user ID that is associated with the application event.

    Time

    The date and time of the application event.
  4. Review the event monitoring information for your deployed application.

Removing

How to:

This section describes how to remove an application from the system.

Procedure: How to Remove an Application

To remove an application:

  1. Click the Management link in the iSM Administration Console.


  2. Click Applications in the left pane.

    The Application pane opens, as shown in the following image.



  3. Click the Remove icon in the Actions column.

    The following confirmation message is displayed.



  4. Click OK.

    The selected application (for example, car) is removed from the Applications pane, as shown in the following image.



iWay Software