Page History

...

<webservice port="8899" sleeptime="15" timeout="600"/> 

Installing the Workflow Runner

...

The Workflow Runner component is started up by the client application (see Examples). This service requires a configuration file that is an instance of the WebService.xsd.

• port: This is the port number on which the FewsWebService will be hosted. This port must be accessible by the client application.
• timeOutSeconds: This is the length of time that the FewsWebService will wait for the workflow to complete runnging.
• inputPiTimeSeriesFile: This is the file from which the MC workflow run will read the input timeseries. When calling the FewsWebService API the timeseries passed as argument will be written to this file. This file must therefore match the file configured in the MC workflow.

• Wiki Markup
  *outputPiTimeSeriesFile \[1..>*: These are the files to which the MC workflow will write the output timeseries. When calling the FewsWebService API the timeseries are read from the output files after the workflow run is completed. These timeseries are returned by the call. These files must therefore match the files configured in the MC workflow.

• mcTaskWebService: This contains information that allows the FewsWebService to connect to a specific running instance of the McTaskWebService. Although this entry is optional it is required!

Example of a WebService xml file.

Starting on Windows

Step 1: Install the webservice package.TODO: Attach the webservice package!

Step 2: Make a new FewsWebService.exe andFewsWebService.jpiffile in the \bin directory. The FewsWebService.jpif must contain the following information...\jre
-mx512m
-cp
$JARS_PATH$
nl.wldelft.fews.webservice.FewsWebServiceRunner
<path to>/WebService.xml

Step 4: Start the FewsWebServiceRunner by clicking on the FewsWebServiceRunner.exe.

Step 5: Stop the FewsWebServiceRunner by killing the application using the System Monitor.

Install windows service

TODO: Package not available!

Starting on Linux

Step 1: Install the webservice package.TODO: Attach the webservice package!

Step 2: Set the correct paths in the fews_webservice.sh script.

Step 3: Start the fews_webservice.sh script by typing ./fews_webservice.sh start

Step 4: To stop the service type ./fews_webservice.sh stop

To make sure that the service keeps running there is also a 'watcher' script. This script should be run as a cron job. What this script does is, check if the web fews webservice script is still running. If the service is not running the it is restarted.

Example code

Here are some examples of how a client application would instantiate a FewsWebService and fire of a workflow to the MC.

Before starting the client will require the following library: xfire-all-1.2.5.jar. This library can be found in the bin directory of the FEWS system.

...