In Progress

(start with notes and then turn it into more eloquent text)

Tuscany runs SCA contributions.
An SCA contribution is something like a zip, jar, or folder.
To run SCA contributions you start a Tuscany runtime and tell it about the contributions.
(need something about domains)

As a very quick example, go to samples/helloworld and do mvn tuscany:run will to the helloworld contribution in a Tuscany runtime

Ways to create a Tuscany runtime:
-mvn tuscany:run
-ant run
-tuscany.bat/tuscany.sh
-Nodefactory.newInstance
-webapp embedded
-webapp shallow integration
-tomcat deep integration

A Tuscany runtime may be standalone or distributed. A standalone runtime knows only about the contributions in that one runtime instance, a distributed runtime also knows about contributions in runtimes which may be in other JVMs and/or machines. By default the runtime created using NodeFactory.newInstance or webapp embedded will run in standalone mode, all the others by default start in distributed mode.

You can configure the Tuscany runtime by passing in configuration properties when creating the runtime. When creating the runtime programatically you can use a Java Properties object, otherwise you can use a config uri string. The uri string has the following formats:
properties:<url to a properties file>
uri:<defaultDomainName>?propertyName=value&propertyName=value&...