1. Running Tuscany with Equinox
The Tuscany distribution is ready to be started as an Equinox runtime.
You can simply go into the "modules" directory in the distribution and type the following command:
Panel |
---|
java -jar osgi-3.5.0-v20090520.jar -clean -console -configuration ..\features\configuration |
2. Running Tuscany with Felix
Download Apache Felix distribution
You can download the latest version of Felix distribution from http://felix.apache.org/site/downloads.cgi. Unzip it into a directoy such as felix-2.0.1.
The following bundles can be found in felix-2.0.1\bundle directory:
- org.apache.felix.bundlerepository-1.4.2.jar
- org.apache.felix.shell-1.4.1.jar
- org.apache.felix.shell.tui-1.4.1.jar
Please download additional bundles into felix-2.0.1\bundle directory:
- org.apache.felix.fileinstall-2.0.0.jar
- org.osgi.compendium-1.4.0.jar
- org.apache.felix.configadmin-1.2.4.jar
To run the web console, you need more bundles:
- org.apache.felix.http.api-2.0.2.jar
- org.apache.felix.http.base-2.0.2.jar
- org.apache.felix.http.bundle-2.0.2.jar
- org.apache.felix.http.jetty-2.0.2.jar
- org.apache.felix.metatype-1.0.4.jar
- org.apache.felix.prefs-1.0.4.jar
- org.apache.felix.scr-1.0.8.jar
- org.apache.felix.eventadmin-1.0.0.jar
- org.apache.felix.webconsole-2.0.0.jar
Add Tuscany bundles
Copy all bundles (jars and folders) under the modules directory of Tuscany distribution to felix-2.0.1\load.
Remove the following Equinox jars from felix-2.0.1\load:
- osgi-3.5.0-v20090520.jar
- services-3.2.0-v20090520-1800.jar
- common-3.5.0-v20090520-1800.jar
Alternatively, Tuscany also provides aggregate jars which simplify the use of Tuscany by minimizing the number of jars required. For this exercise the single base jar includes everything necessary so that single jar can be used in the Felix bundle directory. The releases of this jar can be found in the Maven repository here or the latest development snaphosts here.
Start felix
Panel |
---|
java -jar bin\felix.jar |
Install OSGi remote service sample bundles
Panel |
---|
-> install file:///C:/Tuscany-2.x/java/sca/samples/dosgi-dynamic-calculator/target/sample-dosgi-dynamic-calculator.jar |
Now, the distributed OSGi calculator is available as a Web service at http://rfengt61p:8086/CalculatorService. You can see the WSDL in a browser with URL: http://rfengt61p:8086/CalculatorService?wsdl.
You can now use a web service client such as Eclipse Web Service explorer to invoke the calculator.
Note | ||
---|---|---|
| ||
You can download a JAX-WS client for the calculator sample and run: |
For more information on Tuscany's implementation of OSGi remote services, see: OSGi Remote Services with Tuscany SCA.ppt