OSGi Integration

The Atomikos OSGi bundle

1. If you start the Atomikos OSGi bundle, an implementation of javax.transaction.TransactionManager and javax.transaction.UserTransaction will be registered in the OSGi registry. You”ll be able to do a lookup as requested.
2. If you don't start the Atomikos OSGi bundle, you'll be free to instantiate the Transaction Manager by yourself pretty much like you would do outside the OSGi world (see Spring sample and/or JTA sample).

Running the example(s)

Pre-requisites

• Knowledge of OSGi
• Knowledge of Pax Exam, the test framework for OSGi.

Setting up your environment

Import the OSGI sample in an IDE that supports maven (all maven IDE have maven support). For Eclipse users, you should be able to see something like this:

Running the TransactionsEssentials demo

1. Go to service-tracker-osgi-tests module.
2. Select com.atomikos.osgi.sample.OSGiUnitTest
3. Run as Java application.
4. An OSGi container starts a basic OSGi sample. Open http://localhost:8080/ and play with it.

Running the ExtremeTransactions demo

1. Go to service-tracker-osgi-tests-axt module.
2. Select com.atomikos.osgi.sample.OSGiContainer
3. Run as Java application.
4. Append to the JVM parameters:

   -Dcom.atomikos.icatch.license_folder=<a folder containing a license> 

5. Re-run the Application.
6. An OSGi container starts a basic OSGi sample. Open http://localhost:8080/ and play with it.

Troubleshooting

The config file target/classes/META-INF/maven/dependencies.properties is used by Pax Exam to resolve the right versions of maven modules. If you encounter an error message : "Could not resolve version. Did you configure the plugin in your maven project? Or maybe you did not run the maven build and you are using an IDE?" simply run "mvn compile" on service-tracker-osgi-tests (or service-tracker-osgi-tests-axt).