device-mgmt-agent package
Information on this package is covered here.
|
Package
|
Description
|
License
|
|
device-mgmt-agent
|
Device management agent
|
Devicescape Software, Inc.
|
Summary
The Device Management Agent maintains a central repository of configuration and status data, modeled in a common, object-oriented way. The Device Management Agent uses plugins to translate between the Device Management Agent's representation of configuration data, and the data as it must be stored and used by an individual subsystem.
If, for example, a subsystem uses an XML configuration file, the plugin is responsible for writing configuration data to that file, and for creating a representation of that data using the Device Management Agent's model.
The Device Management Agent loads the plugins, which in tern are responsible for starting the device's various subsystems. Because the Device Management Agent is responsible for starting other subsystems -- essentially, for keeping the device up and running -- the Agent is started and uses the kernel watchdog to keep itself running. If, for any reason, the Device Management Agent stops running while the device is still powered up, the kernel watchdog will restart the process.
API Reference
For a complete API reference, please see Device Management Agent (dman) API Reference (http://www.devicescape.com/docs/wip/apis/dman/index.html on Devicescape Web Docs).
Usage
Start/Stop Options
If the Device Management Agent becomes inactive for a long period, the watchdog process reboots the device and thereby restarts the Device Management Agent. In a production environment, the Device Management Agent must be running; otherwise it is not possible to administer the device.
During development, however, you may want to disable the watchdog. You can build the kernel without the watchdog, and thereby avoid having the device reboot during debugging, etc.
You can start, stop, and restart the Device Management Agent manually using the following commands:.
|
Action
|
Command
|
|
Start
|
/etc/init.d/device-mgmt-agent start
|
|
Stop
|
/etc/init.d/device-mgmt-agent stop
|
|
Restart
|
/etc/init.d/device-mgmt-agent restart
|
Command Line Options
From the CLI, you can use the following options with the dman command:
|
option
|
Description
|
|
-h
|
show command line options (that is, this list)
|
|
-f
|
run in foreground (do not become a daemon)
|
|
-n
|
no actions (executing processes, rebooting, watchdog, etc.)
|
|
-d
|
Show debug messages. Repeat the d for deeper debug levels.
(For example-ddd for the third debug level)
|
|
-e
|
Exit on fatal errors. Useful for making problems more obvious during development.
|
Building the Package
Follow standard instructions for building userspace packages in the Devicescape Developer Guide topic on "Building the Packages", see subtopic: "Building a Userspace Package from a Source RPM"
Licensing
Devicescape Software, Inc.
Related Packages
Required
device-mgmt-agent-ap package
Suggested
device-mgmt-agent-lsql-http (see Quick View of Packages)
device-mgmt-agent-ntp (See Quick View of Packages)
device-mgmt-agent-ssh (See Quick View of Packages)
device-mgmt-agent-web-server (See Quick View of Packages)
