Configuring the OSGi environment

Changing the username and password

Initial configuration

Substituting one module with another

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. By default, Geronimo server uses Equinox as its default OSGi runtime. The following is a list of simple tasks for your demonstration.

• Chaning the OSGi runtime
• Enabling OSGi framework debugging

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.

1. Open config.properties file under /etc directory.
2. Uncomment the line with karaf.framework=equinox and comment out the line with karaf.framework=felix.
3. Specify the location of Flex bundle using the key karaf.framework.felix. The following code snippet is an updated config.properteis file.
   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
   ...
   

4. Save the file and restart the server.

See Apache karaf for more information about those key=value pairs in the config.properties file.

Enabling OSGi framework debugging

The equinox-debug.properties is used to configure debug options for Equinox runtime. To enable debug for the Equinox runtime.

1. Open config.properties file under /etc directory.
2. Comment out the line with *osgi.debug=$
   Unknown macro: {karaf.home}

   /etc/equinox-debug.properties*.

   1. Update value of each parameter in the equinox-debug.properties file as needed. The following code snippet is an updated config.properteis file.
      config.properties

      ...
      #
   2. Debug options for Equinox
      #
      osgi.debug=$
   /etc/equinox-debug.properties
   ...

3. Save the file and restart the server.