Terminology
The following terminology is used throughout the current documentation:
- OSGi Device (in the scope of RM) – presents OSGi enabled device, that is equipped with the RM OSGi Management Agent, and which communicates with the RM server over the RM-native management protocol.
- OSGi enabled device – a device compliant with the OSGi Service Platform Core Specification and Service Compendium.
Like an OSGi device, an OSGi Handset is also considered to be OSGi enabled, but the OSGi handset additionally supports the OSGi Service Platform Mobile Specification and it is managed through the standard OMA DM protocol. OSGi Handset management is subject of the RM Mobile OSGi Device Management package documentation.
Functions
The OSGi Device Management package offers a wide range of functionalities for management of OSGi enabled devices:
- Initial provisioning – An implementation of the Initial Provisioning specification included in the OSGi Service Platform Specification Release 4. In addition to the implementation of the OSGi specification, the RM provisioning supports capabilities for easy discovery of OSGi devices and providing custom optional features to the managed devices.
- Enhanced management of service platform frameworks – Deployment of bundles on the managed devices, management of system properties, bundle configurations and permissions, etc.
- Device management via commands – Management commands can be issued through the GUI, through a special script language, or programmatically. The RM management script allows creating complex commands that can be packed in scripts and stored permanently so as to be reused when necessary. In addition, RM enables creating custom management tasks that can optionally have their own representation in the RM script.
- Device platform administration – Maintenance of platform profiles including compatibility relations between them.
- Extensible protocol for backend-device communication – Hi-level communication protocol based on different transports with optional security layers.
- OSGi (Gateway Software) Device Management related features.
Package Dependencies
The OSGi Device Management package requires the following packages for its proper operation:
- System Package – as it comprises the core of the entire RM system.
- Generic Device Management Package – delivers the general model (called "Control Unit" model) for managing various type of devices and/or other manageable resources in a common way.
- Software Repository Package – this package provides a unified representation of deployment units which can be delivered to different evices and a common way to manage them.
Some extra features of the package require the User Management and the Service Application Management packages, but there are not crucial for the overall performance of the package.
The Generic OSGi Device Management Package provides abstraction not only for the native OSGi devices (for the RM these are devices managed via messaging), but also for all OSGi devices, including OMA DM/OSGi devices and TR069/OSGi devices. The package offers general interface for performing the basic operations over OSGi Devices, but as a generic interface there are some limitations. Therefore when working with specific OSGi devices it is better to use not the Generic OSGi APIs, but the OSGi DM APIs instead.
Directory Structure
Directory | Subdirectory | Description |
|---|---|---|
lib | /api/osgidm-api.jar | The public API of the RM OSGi Device Management Package, which may be used for compilation of custom applications. |
/api/genericosgi-api.jar | The public API of the RM Generic OSGi Device Management Package, which may be used for compilation of custom applications. | |
/rac/osgidm-rac.jar | Remote Access Client library of the RM OSGi Device Management Package. Provides remote connectivity and Java API to the RM servers. | |
/rac/genericosgi-rac.jar | Remote Access Client library of the RM Generic OSGi Device Management Package. Provides remote connectivity and Java API to the RM servers. | |
licenses | /Generic OSGi Device Management | Hold he license agreements for the package. |
/OSGi Device Management | ||
packages | /genericosgi | Contains generic bundles for managing OSGi device. |
/osgidm | Holds bundles of the OSGi Device Management package. |