Page History

{scrollbar}

{excerpt

}Geronimo uses Karaf as the OSGi framework and comes with both Equinox and Felix pre-installed as runtime. You can easily configure the OSGi environment by updating {{.properties}} files under {{/etc}} directory.{excerpt} By default, Geronimo server uses [Equinox|http://www.eclipse.org/equinox/|Equinox] as its default OSGi runtime. The following is a list of simple tasks for your demonstration.

* [Chaning the OSGi runtime|#changingtheosgiruntime]
* [Enabling OSGi framework debugging|#enablingosgiframeworkdebugging ]

h2. Changing the OSGi runtime
The {{config.properties}} file is the system properties file of underlying OSGi framework of Geronimo, in which stores the initial configuration parameters to start up a Karaf framework.

# Open {{config.properties}} file under {{/etc}} directory.
# Uncomment the line with *karaf.framework=equinox* and comment out the line with *karaf.framework=felix*.
# Specify the location of Flex bundle using the key *karaf.framework.felix*. The following code snippet is an updated {{config.properteis}} file.
{code:java|title=config.properties}
...
#
# Framework selection properties
#
#   karaf.framework=

equinox
    karaf.framework=

felix

karaf.framework.

felix=repository/org/apache/

felix/org.apache.felix.framework/3.0.2/org.apache.felix.framework-3.0.2.jar
...

{code}
# Save the file and restart the server.

See [Apache karaf|http://karaf.apache.org|Apache karaf] for more information about those *key=value* pairs in the {{config.properties}} file.

h2. Enabling OSGi framework debugging
The {{equinox-debug.properties}} is used to configure debug options for Equinox runtime. To enable debug for the Equinox runtime.
# Open {{config.properties}} file under {{/etc}} directory.
# Comment out the line with *osgi.debug=${karaf.home}/etc/equinox-debug.properties*.
# Update value of each parameter in the {{equinox-debug.properties}} file as needed. The following code snippet is an updated {{config.properteis}} file.
{code:java|title=config.properties}
...
#
# Debug options for Equinox
#
 osgi.debug=${karaf.home}/etc/equinox-debug.properties
...
{code}
# Save the file and restart the server.