Quickstart Examples - Management
================================

This is a simple example to demonstrate the management APIs that are exposed as RESTful services.

The console username and password are defined as properties in the build.xml file, and have been
configured to use the default values of username 'admin' and password 'admin'. If the username
and/or password have been changed, then the properties will need to be updated with the
appropriate values. To check whether the username and password work correctly, simply log in to the
BPEL console at: http://localhost:8080/bpel-console

Before running this example, it is necessary to create some appropriate information upon which to
issue the management commands. Therefore go to $RiftSaw/samples/quickstart/simple_correlation folder,
and run the following commands:

1. ant deploy
2. ant sendhello
3. ant sendgoodbye
4. ant sendhello2

These commands will result in one active process instance, and one completed process instance.

To run this management example, use the following command:

	ant runtest

The result from this command will show the output from four RESTful services:

1) all deployments: This service returns all of the deployed artifacts on the server.
2) all process definitions: This services returns all of the process definitions that are deployed on the server.
3) active process instances: The list of active process instances, in this case for the simple_correlation example.
4) historic process instances: The list of historic (completed) process instances, in this case for the simple_correlation example.

By default, all of the RESTful services are secured by form authentication, except the status and deployment services.

In the example, the RESTful services are initially invoked, and then the JSON result is marshalled into Java Objects using
the third party Gson library.

All of the RESTful services are built within the bpm-console project. For further details please refer to
https://github.com/bpmc/bpm-console/.


Some handy URLs:

http://localhost:8080/gwt-console-server/rs/server/resources/riftsaw  RiftSaw RESTful Services document in html format.
