Skip to content
This repository has been archived by the owner on Aug 25, 2024. It is now read-only.

Home

Jump to bottom
DirkMahler edited this page Apr 23, 2013 · 6 revisions

##MAEXO - Management Extensions for OSGi The MAEXO project enables JMX based management of OSGi containers and applications. It offers an easy to use programming model for dealing with JMX resources within an OSGi application.

As a showcase, the framework is used to export core OSGi services and resources to JMX.

The project aims at portability, minimal dependencies and user-friendliness.

The project consists of:

  • The Switch Board bundle: The MAEXO core component to link MBeans, MBean Notifications, MBean-Servers and MBean-Server-Connections with the OSGi environment
  • The OSGi-Core MBeans bundle: Exporter of bundles available in the the OSGi container and services from the OSGi Core specification as MBeans (FrameworkMBean, BundleMBean, ServiceMBean, PackageAdminMBean and StartLevelMBean)
  • The MX4J HTTP adaptor bundle: The MX4J HTTP adaptor to be used within the OSGi container
  • Various samples which demonstrate how to enable management of OSGi based applications using MAEXO and the integration with other technologies (Declarative Services, Spring Dynamic Modules).

##License MAEXO is provided under Apache License 2.0.

##System Requirements

  • Java Runtime Environment 5 or higher
  • OSGi R 4 Service Platform (Equinox and Felix are included in the distribution)

##Getting Started

  • For getting a first impression on MAEXO watch the screen cast.
  • Download the latest release and unpack it into a directory.
  • Navigate to the sub-directory "samples/basic/".
  • Take a look at the file readme.txt for explanations on the setup of the sample.
  • Run one of the provided shell scripts for Equinox or Felix (Win/Unix).
  • Open your management console and inspect the MBeans registered under the the domain "com.buschmais.maexo":

    Open your browser and open the URL http://localhost:8081.

    Run JConsole or VisualVM and connect to the running OSGi Container.

  • see Use cases for MAEXO MBeans for the usage of the MBeans provided by MAEXO

##Feedback, Questions and Issues

If you want to provide feedback on the project or you have questions please use the MAEXO discussion group. You may also raise an issue if you are missing a feature or you are facing problems.

Clone this wiki locally