Provides information about the steps to be performed in order to manage alerts generated by the end OSGi device.
The basic principles of the RM Alert Board Service are described in Alert Board Service Conceptual Guide . How to create a bundle capable of generating alerts is described in Alert Board Service Programmer's Guide .
Installation and Setup
On the RM Backend
To be able to retrieve device-generated alerts from the alert board of RM, you need to have the Alert Board Backend Service bundle (packages/system/system.alert.be.jar) running on each backend server host. By default, this bundle is running when you start the backend framework, so you don't need to install any components unless you have explicitly uninstalled this bundle.
On Managed Devices
On managed devices, install and start the Device Alert Board Agent bundle (packages/osgidm/osgidm.alert.agent.jar). This bundle is responsible for supervising the local alerts and sending them to the corresponding Management Server. If the device has been registered with the Alert Service optional feature selected, the Device Alert Agent bundle is activated automatically on that device.
Note: Alert messages which are generated on managed devices are not visible to the RM backend without installing and starting an alert agent.
Note: If you do not activate an alert agent, you will still be able to obtain device-related alerts generated by the backend. The alert agent is responsible only for the alerts created locally on the managed device.
Configuring the Device Alert Agent
The Device Alert Agent possesses a bundle configuration with name "Alert Board Agent" and PID: prm.alerts.pid. It contains the following configuration property:
ID | User Friendly Name | Type | Default Value | Description |
|---|---|---|---|---|
refreshInterval | Refresh Interval | Integer | 60 | Specifies the time period after which the system will refresh the alerts of the registered services under the Supervisable interface in the current framework. |
You can edit the bundles' configurations through the console.
User Interface
The console provides a user interface for reading alert messages generated on separate devices. See the Alert Board document from User's Guide for more details.
Alert Board API
The Alert Board API allows custom bundles running on the RM backend or managed devices to send alerts whenever they need to notify of their malfunctioning or require human assistance. See Alert Board Service Programmer's Guide for details.