Agent plugins can provide canned DynaGroup expressions. Such expressions become available to a user in UI when he creates DynaGroup definition and can serve as examples. Optionally such expressions can be auto-deployed as regular dynaGroups.
DynaGroup expressions live in standalone XML descriptor file META-INF/rhq-group-expressions.xml within your plugin.jar. There is a XSD being used to validate and parse descriptor.
See following example from Platform Plugin:
More examples can be found for example in JBossAS7 plugin.
All definitions from all plugins are listed in Provided Expressions list whenever user edits or creates DynaGroup Definitionin UI.
Definitions having createByDefault=true
- DynaGroup definition is created or updated when plugin is deployed to server.
- DynaGroup definition is kept in sync with plugin whenever new version of plugin is deployed to server.
- All DynaGroup definitions provided by plugins are removed when plugin is uninstalled from server.
- When user changes plugin provided DynaGroup it gets detached from plugin - such definition will no longer be updated when plugin updates.