DOSGi Single Bundle Distribution

Setting up your OSGi container

Setting up the single-bundle distribution is really simple, see below.

Prerequisites for the single-bundle distribution:

The single-bundle distribution requires some of the interfaces of the OSGi compendium specification. These are provided with the Equinox and Felix OSGi distributions, but not installed by default.

Setting up Felix

The compendium interfaces can be downloaded from the following various places, the easiest is probably from Maven Central, for example:
"g! install http://repo1.maven.org/maven2/org/osgi/org.osgi.compendium/4.2.0/org.osgi.compendium-4.2.0.jar".
(Note: this step is not required for DOSGI RI 1.3)

To set up Felix you can follow these steps:
Verified with: Felix 4.0.2 and DOSGI RI 1.3

../felix-4.0.2> java -jar bin/felix.jar

Welcome to Apache Felix Gogo
g! start http://www.apache.org/dist/cxf/dosgi/1.3/cxf-dosgi-ri-singlebundle-distribution-1.3.jar
... some log messages may appear...
g! lb
    0|Active     |    0|org.apache.felix.framework (4.0.2)
    1|Active     |    1|org.apache.felix.bundlerepository (1.6.6)
    2|Active     |    1|org.apache.felix.gogo.command (0.12.0)
    3|Active     |    1|org.apache.felix.gogo.runtime (0.10.0)
    4|Active     |    1|org.apache.felix.gogo.shell (0.10.0)
    5|Active     |    1|cxf-dosgi-ri-singlebundle-distribution (1.3.0)

However, you can also change the conf/config.properties file to automatically load these bundles. This approach is described in the Multi Bundle Setup page.

Setting up Equinox

The compendium interfaces are part of the Equinox/Eclipse distribution and can be found in a file called plugins/org.eclipse.osgi.services_3.2.0.v20090520-1800.jar (the timestamp could vary), for example:
"osgi> install file:plugins/org.eclipse.osgi.services_3.2.100.v20100503.jar"
(Note: this step is not required for DOSGI RI 1.3)

To set up Equinox you can follow these steps:
Verified with: Eclipse 3.6.2

.../eclipse> java -jar plugins/org.eclipse.osgi_3.6.2.R36x_v20110210.jar -console

osgi> install http://www.apache.org/dist/cxf/dosgi/1.3/cxf-dosgi-ri-singlebundle-distribution-1.3.jar
Bundle id is 1

osgi> start 1
... some log messages may appear...
osgi> ss

Framework is launched.

id      State       Bundle
0       ACTIVE      org.eclipse.osgi_3.6.2.R36x_v20110210
1       ACTIVE      cxf-dosgi-ri-singlebundle-distribution_1.3.0

However, you can also create a config.ini file to automatically load these bundles. This approach is described in the Multi Bundle Setup page.

Using Equinox from within the Eclipse IDE

This option is really handy for debugging. Verified with: Eclipse 3.5M4
Setting up Eclipse for Running and Debugging Distributed OSGi