This is an old revision of the document!


MOTEUR2 pre-release

MOTEUR2 is available as a pre-release (v0.9).

Downloads

Download jar archives from http://proton.polytech.unice.fr/moteur2. Make your choice of:

  • A self-contained jar archive: moteur2-client.jar
  • A stand-alone jar archive contained in: moteur2-client.zip, which includes both the client jar moteur2-client-<version>.jar and its dependencies in the lib directory. Upon execution, the CLASSPATH environment variable is overiden in the jar archive MANIFEST file. The lib sub-directory containing dependencies is expected to be found in the archive's directory.

The client contains the moteur server component and it will auto-start a local server upon execution if none is found already running. However, if you want to run a separate server (running on a separate machine or started has an independent process), then you will also need to download the independent server jar archive: moteur2-server.jar.

Installation

You need Java Runtime Environment v6 installed on your computer (get it here ). MOTEUR2 also depends on GraphViz's graph representation tools. Download GraphViz here (UNIX / windows) or there (MacOSX).

Run MOTEUR2 client to initiate the configuration procedure:

> java -jar moteur2-client-<version>-jar-with-dependencies.jar

On first run, you will have to give the dot executable location (from GraphViz's package). Default is in /usr/local/bin.

Execution

The client is used for workflows design and execution monitoring. The server is used for workflow execution enactment. When starting a client, the graphical designer/monitoring interface appears (unless the –no-gui option is used):

> java -jar moteur2-client-*-jar-with-dependencies.jar

As soon as a workflow execution is requested, the client connects to the server (or auto-start a server if none is running).

In case you want to start an independent server process, start the server prior to starting workflow execution from the client with:

> java -jar moteur2-server-*-jar-with-dependencies.jar

Use the –help option for detailed command line information.

Development

Deployment of application services

The MOTEUR workflow engines support different kind of services:

  • command-line tools wrapped with the jGASW wrapper and accessible as Web Services (executable on gLite and locally)
  • regular Web Services
  • command-line tools wrapped with the GASW wrapper (executable on gLite, OAR/G5K and locally)
  • local java code (beanshell)

Pre-deployed Web Services (including jGASW-wrapped tools) hosted in an Axis2 or a Tomcat service container are browsable from the MOTEUR2 editor.

The recommended method to deploy new command-line based application services is to use the jGASW wrapper tool (use the tool GUI to create and deploy the Web Service bundle) and host services in a Tomcat container. To do so, a Tomcat server with the metro Web Service software stack is needed.

Tomcat container installation

  1. Download tomcat version 6.0.18 from Tomcat archive and declare $CATALINA_HOME environment variable
  2. Download metro from https://metro.dev.java.net/1.5
  3. unarchive metro: java -jar metro-1_5.jar
  4. deploy metro within tomcat: ant -Dtomcat.home=$CATALINA_HOME -f metro/metro-on-tomcat.xml install (see metro documentation ). - copy all jGASW dependencies found here in $CATALINA_HOME/lib

Wrapping command line tools with jGASW

  1. download jGASw UI and Tools jar archives from here
  2. run service packaging interface with java -jar jgasw-ui-*-bin.jar - run service deployment tool with java -jar jgasw-tools-*-dist.jar

Invoking Web Services from MOTEUR

To add a Web Service in a workflow, the easiest way is to use the service discoverer included in MOTEUR2 through the Edit → Browse menu item. You can drag service operations that are listed in the browser window into the workflow edition canvas. The resulting processor will be configured with the service WSDL, operation invoked and corresponding input / output ports. To populate the browser window, you can provide endpoints to services deployed or to service containers (e.g. your own tomcat container): - Endpoints to services deployed: select the custom services list item in the list of repositories and use the (+) button to enter the URL of the service WSDL.

  1. Listing containers content: MOTEUR2 is capable of browsing the content of AXIS2 server containers. Press the (+) button and enter the container URL. MOTEUR2 can also browse the content of Tomcat server containers if a specific discovery service is hosted within this server. The service discovery archive for Tomcat is available here. Just copy this file in your $CATALINA_HOME/webapps folder.