Consortium Activities Projects Forge Events

Aspire :: Deployment of Filtering And Collection Server on OSGi

1 Aspire :: Deployment of Filtering And Collection Server on OSGi

----
#toc("" "" "true")
----

1.1 Introduction

Deployment of the Filtering And Collection Server on OSGi platform provides to the middleware two important properties:

* Modularity: Extensions to the F&amp;C server as addition of new readers or sensors should be provided in a modular fashion. Using OSGi approach, new readers are developed without introduce their driver code in the same archive (war) used to package the ALE Server.
* Dynamicity: These new modules will be deployed (or undeployed) on the platform dynamically without stopping the applications that are currently in execution.

However, deployment on OSGi imposes some conditions on the F&amp;C server provisioning. This document will explain how to deploy the Fosstrak ALE Server on OSGi platform. The document is organized as follows: first installation of OSGi platform is presented. Then, how the war archive is transformed in a compliant OSGi bundled is showed. Next, the installation of a reader driver is illustrated, follow by installation of a sensor driver. Finally, additional features installation is explained.

{image:aleosgiarch.png|width=784|height=445}

Figure : architecture of the ALEServer' OSGi profile ({attach:HiRes picture|file=aleosgiarch.png})

1.1 Transformation of ALE Server web application in an OSGi compliant bundle

This transformation consists only in the addition of a MANIFEST.MF file into the war archive. This manifest file must be OSGi compliant, indicating the bundle dependencies and capabilities and also other meta-data used by the OSGi platform. In OSGi profile, we have added the manifest file, also Sensor communication and JMX management features. In the project *aleserver-bundle* the specific files to support these features are found.

Instructions to build the F&C server are [here>http://wiki.aspire.ow2.org/xwiki/bin/view/Main.Documentation/Filtering%26Collection#HBuilding]

1.1 Deployment of F&C Server on OSGI platform

1.1.1 Installation of an OSGi platform with web application support

First download an OSGi distribution such as [Apache Felix>http://felix.apache.org] (current version is 2.0.1). Then, install [Pax Web>http://wiki.ops4j.org/display/paxweb/Pax+Web] (implementation of OSGi Http Service) and their dependencies (current version is 0.7.2). Finally, install the [Pax Web Extender>http://wiki.ops4j.org/display/paxweb/Pax+Web] (current version is 0.7.2) with provides a transparent (for JEE war archive) registration of servlets on the OSGi platform.

These steps can be performed easily using the [Pax Runner>http://paxrunner.ops4j.org/space/Pax+Runner] tool (an intenet connection is required). Simply, download the Pax Runner, then in a console execute the command ~~ pax-run \-\-platform=felix \-\-dir=ale war config~~

This command install (and launch) the Felix platform into the directory ~~ale~~.  The last arguments indicate to Pax Runner which [profiles>http://paxrunner.ops4j.org/display/paxrunner/Pax+Runner+profiles+list] it should install, war is the web support profile and config the configuration admin service.

In some windows system the command must be typed as ~~pax-run &quot;\-\-platform=felix&quot; &quot;\-\-dir=ale&quot; war config~~

1.1.1 Other necessary bundles

In order to support sensor extensions is necessary also to install the [Wire Admin>http://svn.apache.org/viewvc/felix/trunk/wireadmin/] bundle (compiled version {attach:wireadmin.jar} ) and [Wire Admin Binder>http://svn.apache.org/viewvc/felix/sandbox/donsez/wireadminbinder/src/site/readme.html?view=co] (compiled version {attach:wireadmin-binder.jar}) bundles.

Install the bundles using the associated command in your OSGi distribution. For Felix distribution use the next commands

~~install file:path/wireadmin.jar~~
~~install file:path/wireadmin-binder.jar~~

1.1.1 Instalation of F&C server bundle

In Felix platform you can install the server bundle using the next command

~~install file:path/aleserver-bundle.war~~

1.1 Installation of Readers' Drivers

Readers' Drivers are installed as bundles on the OSGi platform. Next readers' drivers have been included in the OSGi profile:

* [Simple Reader (an reader simulator)>Main.Documentation.Bundles.SimpleReader]
* [ProximaRF Desktop USB reader>Main.Documentation.Bundles.ProximaRFDesktopReader]
* [TagSys Medio Serial reader>Main.Documentation.Bundles.TagSysMedioReader]
* [ACR 122 USB reader>Main.Documentation.Bundles.ACR122Reader]
* [OneWire reader>Main.Documentation.Bundles.OneWireReader]

Use the Felix command [install>http://felix.apache.org/site/documentation.html] to deploy each reader bundle and its dependencies.

1.1 Installation of the temperature sensors

Two temperature sensors are provided in this distribution, At first,a fictive sensor that can be used for test purposes, and a Temper sensor that is the driver of an usb sensor temperature device. Require bundles are also provided (iPojo version 1.4.0).

Readers' bundles and sensors' bundles are shown in the next osgi console snapshot:

{image:ALE-OSGi.png}

1.1 Installation of other features bundles

The platform can be enriched using other bundles to add different features. By example, a bundle allowing administration of OSGi platform using the [Visual VM OSGi plugin>http://membres-liglab.imag.fr/kiev.gama/dev/osgi/visualvm/] is provided.

1.1 All-in-one distribution

A distribution with all required bundles is available [here>http://chaphe.free.fr/aspire/ale.zip]. Download the file and unzip it, then execute run.sh (or run.bat in Windows).

1.1 Misc
* [CiliaALE>Main.Documentation.ALEinCilia] : a flexible and dynamically reconfigurable ALE Server for Android platforms (phones and tablets)