Jump to: navigation, search

Difference between revisions of "Libra/User Guide"

m (Configuring the Bundle Information and Bundle Dependency Graph editor parts)
(Configuring the Bundle Information and Bundle Dependency Graph editor parts)
Line 32: Line 32:
  
 
The ''Bundle Information'' and ''Bundle Dependency Graph'' editor parts are new features available since milestone 0.2 M3 (Juno M3). They appear in the server editor of the OSGi Framework server adapters (like Equinox, Felix and Knopflerfish). These editor parts display the state and the dependencies of the bundles that are installed in the OSGi Framework. They use the standard OSGi JMX Management Model for retrieving the necessary information from the OSGi Framework. The below steps shows how to enable OSGi JMX for your OSGi Framework.
 
The ''Bundle Information'' and ''Bundle Dependency Graph'' editor parts are new features available since milestone 0.2 M3 (Juno M3). They appear in the server editor of the OSGi Framework server adapters (like Equinox, Felix and Knopflerfish). These editor parts display the state and the dependencies of the bundles that are installed in the OSGi Framework. They use the standard OSGi JMX Management Model for retrieving the necessary information from the OSGi Framework. The below steps shows how to enable OSGi JMX for your OSGi Framework.
 +
 +
=== Adding OSGi JMX Provider ===
 +
 +
First, you need to install an OSGi Bundle your OSGi Framework that will provide and register the required OSGi JMX MBeans. There are several open source implementations that can be used:
 +
* [http://www.eclipse.org/gemini/management/ Eclipse Gemini Management]
 +
* [http://aries.apache.org/downloads/currentrelease.html Apache Aries JMX]
 +
* [http://code.google.com/p/osgilab/wiki/JMX KnowHowLab JMX]
 +
 +
The easiest one for setting up is the one by KnowHowLab:
 +
# Download the [http://osgilab.googlecode.com/files/jmx-1.0.2.jar jmx-1.0.2] bundle or a newer version.
 +
# Save the bundle in a separate directory on the local filesystem.
 +
# Open the server editor of the Libra Launcher server adapter (like Equinox or Felix).
 +
# Switch to the ''Target Platform Profile'' editor part.
 +
# Add the directory with the downloaded bundle to the target platform.
 +
# Save the editor. 
 +
 +
Gemini and Aries implementations can be used too, but there must be additional bundle to be installed in the framework that will trigger the registration of the JMX MBeans.

Revision as of 08:43, 21 October 2011

Installation

The Libra features can be installed from the p2 repository of the Indigo Simultaenous Release (since Indigo M6). As a prerequisite you may install Eclipse IDE for Java EE Developers.

The update site contains:

  • OSGi Bundle Facet feature that introduces:
    1. A new facet OSGi Bundle for Dynamic Web, JPA and Utility projects.
    2. Wizard for converting WTP standard projects to OSGi Enterprise bundle projects:
      • Dynamic Web projects to Web Application Bundle projects
      • JPA projects to Persistent Bundle projects
      • Utility projects and simple Java projects to OSGi Bundle projects
Both options modify project's MANIFEST.MF in order to become a valid OSGi bundle.

The facet may be enabled during the project creation or after that from the Properties page of the project. The wizard is available from project's context menu Configure > Convert to OSGi Bundle Projects...

Note that you may need to adjust your target platform accordingly.

LibraInstall.png

Create new Web Application Bundle

  1. Call the New Dymanic Web Project wizard: New > Project... > Web > Dynamic Web Project
  2. Enter the necessary project information like Project name, Target runtime, etc.
  3. Add the OSGi Bundle facet in the Configuration:
    1. Click on the Modify... button in the Configuration group.
    2. Choose the OSGi Bundle facet in the Project Facets dialog and click OK.
  4. Click Finish to create the Web Application Bundle project.

Configuring the Bundle Information and Bundle Dependency Graph editor parts

The Bundle Information and Bundle Dependency Graph editor parts are new features available since milestone 0.2 M3 (Juno M3). They appear in the server editor of the OSGi Framework server adapters (like Equinox, Felix and Knopflerfish). These editor parts display the state and the dependencies of the bundles that are installed in the OSGi Framework. They use the standard OSGi JMX Management Model for retrieving the necessary information from the OSGi Framework. The below steps shows how to enable OSGi JMX for your OSGi Framework.

Adding OSGi JMX Provider

First, you need to install an OSGi Bundle your OSGi Framework that will provide and register the required OSGi JMX MBeans. There are several open source implementations that can be used:

The easiest one for setting up is the one by KnowHowLab:

  1. Download the jmx-1.0.2 bundle or a newer version.
  2. Save the bundle in a separate directory on the local filesystem.
  3. Open the server editor of the Libra Launcher server adapter (like Equinox or Felix).
  4. Switch to the Target Platform Profile editor part.
  5. Add the directory with the downloaded bundle to the target platform.
  6. Save the editor.

Gemini and Aries implementations can be used too, but there must be additional bundle to be installed in the framework that will trigger the registration of the JMX MBeans.