org.rhq.enterprise.server.plugin

Class ServerPluginManagerBean

java.lang.Object

org.rhq.enterprise.server.plugin.ServerPluginManagerBean

All Implemented Interfaces:

ServerPluginManagerLocal, ServerPluginManagerRemote

public class ServerPluginManagerBean
extends Object
implements ServerPluginManagerLocal, ServerPluginManagerRemote

A server API into the server plugin infrastructure.

Author:

John Mazzitelli

Constructor Summary

Constructors

Constructor and Description
ServerPluginManagerBean()

Method Summary

Methods

Modifier and Type	Method and Description
void	acknowledgeDeletedPluginsBy(int serverId) The provided server acknowledges the deletion of all plugins marked as deleted by calling this method.
List<org.rhq.core.domain.plugin.PluginKey>	deleteServerPlugins(org.rhq.core.domain.auth.Subject subject, List<Integer> pluginIds) Removes the plugins from the system and unschedules their jobs.
List<org.rhq.core.domain.plugin.PluginKey>	disableServerPlugins(org.rhq.core.domain.auth.Subject subject, List<Integer> pluginIds) Disables the plugins and unschedules their jobs.
List<org.rhq.core.domain.plugin.PluginKey>	enableServerPlugins(org.rhq.core.domain.auth.Subject subject, List<Integer> pluginIds) Enables the plugins and restarts them.
List<org.rhq.core.domain.plugin.ServerPlugin>	getAllServerPlugins() Returns a list of all the installed and deleted server plugins in the database.
List<org.rhq.core.domain.plugin.ServerPlugin>	getAllServerPluginsById(List<Integer> pluginIds) Get a list of both installed and deleted plugins from their IDs.
List<org.rhq.core.domain.plugin.ServerPlugin>	getDeletedPlugins() Returns the plugins that have been marked as deleted.
List<org.rhq.core.domain.plugin.ServerPlugin>	getEnabledServerPluginsByType(String type) Return all the server plugins that match a certain type string.
Map<ServerPluginType,List<org.rhq.core.domain.plugin.PluginKey>>	getInstalledServerPluginsGroupedByType() This will return a map containing all installed plugins that are both enabled and disabled.
long	getLastConfigurationChangeTimestamp(int pluginId) Given a plugin ID, this will return a timestamp (in epoch millis) that indicates the last time when the plugin's configuration changed.
org.rhq.core.domain.plugin.ServerPlugin	getServerPlugin(org.rhq.core.domain.plugin.PluginKey key) Returns a plugin with the given key.
org.rhq.core.domain.configuration.definition.ConfigurationDefinition	getServerPluginConfigurationDefinition(org.rhq.core.domain.plugin.PluginKey pluginKey) Returns the definition for the given plugin's global plugin configuration.
List<ControlDefinition>	getServerPluginControlDefinitions(org.rhq.core.domain.plugin.PluginKey pluginKey) Returns the metadata for all control operations for the given plugin.
ServerPluginDescriptorType	getServerPluginDescriptor(org.rhq.core.domain.plugin.PluginKey pluginKey) Given a plugin key, returns the descriptor for that plugin.
List<org.rhq.core.domain.plugin.PluginKey>	getServerPluginKeysByEnabled(boolean enabled) Returns a list of plugin keys for only those server plugins whose enabled flag is equal to the given parameter.
org.rhq.core.domain.plugin.ServerPlugin	getServerPluginRelationships(org.rhq.core.domain.plugin.ServerPlugin plugin) Methods in this object that return plugins normally do not include the data from relationships with the plugin (for example, the plugin configuration and scheduled jobs related to the plugin).
List<org.rhq.core.domain.plugin.ServerPlugin>	getServerPlugins() Returns a list of all the installed server plugins in the database
List<org.rhq.core.domain.plugin.ServerPlugin>	getServerPlugins(org.rhq.core.domain.auth.Subject subject) Returns a list of all the installed server plugins in the database, minus the content object.
List<org.rhq.core.domain.plugin.ServerPlugin>	getServerPluginsById(List<Integer> pluginIds) Get a list of plugins from their IDs.
org.rhq.core.domain.configuration.definition.ConfigurationDefinition	getServerPluginScheduledJobsDefinition(org.rhq.core.domain.plugin.PluginKey pluginKey) Returns the definition for the given plugin's scheduled jobs configuration.
org.rhq.core.domain.plugin.PluginStatusType	getServerPluginStatus(org.rhq.core.domain.plugin.PluginKey pluginKey) Given the key of a server plugin, this will return the status of that plugin.
ControlResults	invokeServerPluginControl(org.rhq.core.domain.auth.Subject subject, org.rhq.core.domain.plugin.PluginKey pluginKey, String controlName, org.rhq.core.domain.configuration.Configuration params) Invokes a control operation on a given plugin and returns the results.
boolean	isReadyForPurge(int pluginId) A helper method for PurgePluginsJob.
void	purgeServerPlugin(int pluginId) Purges the server plugin from the database.
org.rhq.core.domain.plugin.ServerPlugin	registerServerPlugin(org.rhq.core.domain.auth.Subject subject, org.rhq.core.domain.plugin.ServerPlugin plugin, File pluginFile) Registers the given plugin to the database.
void	restartMasterPluginContainer(org.rhq.core.domain.auth.Subject subject) Recycles the master plugin container, essentially shutting down all server plugins and then restarting them.
void	setServerPluginEnabledFlag(org.rhq.core.domain.auth.Subject subject, int pluginId, boolean enabled) Turns on or off the enabled flag in the database but does NOT restart the server plugin.
void	setServerPluginStatus(org.rhq.core.domain.auth.Subject subject, List<Integer> pluginIds, org.rhq.core.domain.plugin.PluginStatusType status) Sets the status flag in the database but does NOT restart the server plugin container.
org.rhq.core.domain.plugin.ServerPlugin	updateServerPluginExceptContent(org.rhq.core.domain.auth.Subject subject, org.rhq.core.domain.plugin.ServerPlugin plugin) Given a plugin that already exists, this will update that plugin's data in the database, except for the content, which is left as-is.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ServerPluginManagerBean

public ServerPluginManagerBean()

Method Detail

restartMasterPluginContainer

public void restartMasterPluginContainer(org.rhq.core.domain.auth.Subject subject)

Description copied from interface: ServerPluginManagerRemote

Recycles the master plugin container, essentially shutting down all server plugins and then restarting them.

Specified by:

restartMasterPluginContainer in interface ServerPluginManagerRemote

Parameters:

subject - the user asking to restart the master plugin container

getServerPlugins

public List<org.rhq.core.domain.plugin.ServerPlugin> getServerPlugins()

Description copied from interface: ServerPluginManagerLocal

Returns a list of all the installed server plugins in the database

Specified by:

getServerPlugins in interface ServerPluginManagerLocal

Returns:

all installed server plugins found in the DB

getAllServerPlugins

public List<org.rhq.core.domain.plugin.ServerPlugin> getAllServerPlugins()

Description copied from interface: ServerPluginManagerLocal

Returns a list of all the installed and deleted server plugins in the database. When a plugin is "undeployed", it still exists in the database, but is flagged as "deleted". This method returns those deleted plugins in addition to those plugins that are still installed.

Specified by:

getAllServerPlugins in interface ServerPluginManagerLocal

Returns:

all installed and deleted server plugins found in the DB

getDeletedPlugins

public List<org.rhq.core.domain.plugin.ServerPlugin> getDeletedPlugins()

Description copied from interface: ServerPluginManagerLocal

Returns the plugins that have been marked as deleted. This is more or less a helper method to PurgePluginsJob which goes ahead and removes such plugins from database once it's safe to do so.

Specified by:

getDeletedPlugins in interface ServerPluginManagerLocal

getServerPlugin

public org.rhq.core.domain.plugin.ServerPlugin getServerPlugin(org.rhq.core.domain.plugin.PluginKey key)

Description copied from interface: ServerPluginManagerLocal

Returns a plugin with the given key.

Specified by:

getServerPlugin in interface ServerPluginManagerLocal

Parameters:

key - identifies the plugin to find

Returns:

the named plugin

getServerPluginRelationships

public org.rhq.core.domain.plugin.ServerPlugin getServerPluginRelationships(org.rhq.core.domain.plugin.ServerPlugin plugin)

Description copied from interface: ServerPluginManagerLocal

Methods in this object that return plugins normally do not include the data from relationships with the plugin (for example, the plugin configuration and scheduled jobs related to the plugin). Call this method to fill in that data that wasn't originally loaded.

Specified by:

getServerPluginRelationships in interface ServerPluginManagerLocal

Returns:

the same plugin, with the relationship data loaded

getServerPluginsById

public List<org.rhq.core.domain.plugin.ServerPlugin> getServerPluginsById(List<Integer> pluginIds)

Description copied from interface: ServerPluginManagerLocal

Get a list of plugins from their IDs.

Specified by:

getServerPluginsById in interface ServerPluginManagerLocal

Parameters:

pluginIds - the IDs of the plugins to load.

Returns:

plugins matching the given IDs

getEnabledServerPluginsByType

public List<org.rhq.core.domain.plugin.ServerPlugin> getEnabledServerPluginsByType(String type)

Description copied from interface: ServerPluginManagerLocal

Return all the server plugins that match a certain type string. This type is defined in the XML schema of the plugin descriptor. Example for alert sender plugins: "org.rhq.enterprise.server.xmlschema.generated.serverplugin.alert.AlertPluginDescriptorType" from rhq-serverplugin-alert.xsd.

Specified by:

getEnabledServerPluginsByType in interface ServerPluginManagerLocal

Parameters:

type - Name of the type

Returns:

List of server plugins matching that type.

getAllServerPluginsById

public List<org.rhq.core.domain.plugin.ServerPlugin> getAllServerPluginsById(List<Integer> pluginIds)

Description copied from interface: ServerPluginManagerLocal

Get a list of both installed and deleted plugins from their IDs.

Specified by:

getAllServerPluginsById in interface ServerPluginManagerLocal

Parameters:

pluginIds - the IDs of the plugins to load.

Returns:

plugins matching the given IDs

getLastConfigurationChangeTimestamp

public long getLastConfigurationChangeTimestamp(int pluginId)

Description copied from interface: ServerPluginManagerLocal

Given a plugin ID, this will return a timestamp (in epoch millis) that indicates the last time when the plugin's configuration changed. This looks at both plugin configuration and schedule job configuration.

Specified by:

getLastConfigurationChangeTimestamp in interface ServerPluginManagerLocal

Returns:

time when the plugin's configuration was last updated; will be 0 if the plugin has no configuration to change.

getServerPluginDescriptor

public ServerPluginDescriptorType getServerPluginDescriptor(org.rhq.core.domain.plugin.PluginKey pluginKey)
                                                     throws Exception

Description copied from interface: ServerPluginManagerLocal

Given a plugin key, returns the descriptor for that plugin.

Specified by:

getServerPluginDescriptor in interface ServerPluginManagerLocal

Returns:

descriptor parsed from the file in the plugin jar

Throws:

Exception - if the descriptor could not be retrieved or parsed for the given plugin

getServerPluginKeysByEnabled

public List<org.rhq.core.domain.plugin.PluginKey> getServerPluginKeysByEnabled(boolean enabled)

Description copied from interface: ServerPluginManagerLocal

Returns a list of plugin keys for only those server plugins whose enabled flag is equal to the given parameter.

Specified by:

getServerPluginKeysByEnabled in interface ServerPluginManagerLocal

Parameters:

enabled - if true, return only the keys of plugins that are enabled; if false, return only the keys of plugins that are disabled.

Returns:

list of plugin keys that match the enabled criteria

enableServerPlugins

public List<org.rhq.core.domain.plugin.PluginKey> enableServerPlugins(org.rhq.core.domain.auth.Subject subject,
                                                             List<Integer> pluginIds)
                                                               throws Exception

Description copied from interface: ServerPluginManagerRemote

Enables the plugins and restarts them.

Specified by:

enableServerPlugins in interface ServerPluginManagerRemote

Parameters:

subject - user making the request

pluginIds - the plugins to be enabled

Returns:

the list of keys of the plugins that were enabled

Throws:

Exception - if failed to disable a plugin

disableServerPlugins

public List<org.rhq.core.domain.plugin.PluginKey> disableServerPlugins(org.rhq.core.domain.auth.Subject subject,
                                                              List<Integer> pluginIds)
                                                                throws Exception

Description copied from interface: ServerPluginManagerRemote

Disables the plugins and unschedules their jobs.

Specified by:

disableServerPlugins in interface ServerPluginManagerRemote

Parameters:

subject - user making the request

pluginIds - the plugins to be disabled

Returns:

the list of keys of the plugins that were disabled

Throws:

Exception - if failed to disable a plugin

deleteServerPlugins

public List<org.rhq.core.domain.plugin.PluginKey> deleteServerPlugins(org.rhq.core.domain.auth.Subject subject,
                                                             List<Integer> pluginIds)
                                                               throws Exception

Description copied from interface: ServerPluginManagerRemote

Removes the plugins from the system and unschedules their jobs.

Specified by:

deleteServerPlugins in interface ServerPluginManagerRemote

Parameters:

subject - user making the request

pluginIds - the plugins to be undeployed

Returns:

the list of keys of plugins that were undeployed

Throws:

Exception - if failed to undeploy a plugin

setServerPluginEnabledFlag

public void setServerPluginEnabledFlag(org.rhq.core.domain.auth.Subject subject,
                              int pluginId,
                              boolean enabled)
                                throws Exception

Description copied from interface: ServerPluginManagerLocal

Turns on or off the enabled flag in the database but does NOT restart the server plugin. This has "requires new" semantics, so the results are committed immediately upon return.

Specified by:

setServerPluginEnabledFlag in interface ServerPluginManagerLocal

Parameters:

subject - user making the request

pluginId - the plugin to be enabled

enabled - the value of the enabled flag for the plugin

Throws:

Exception

setServerPluginStatus

public void setServerPluginStatus(org.rhq.core.domain.auth.Subject subject,
                         List<Integer> pluginIds,
                         org.rhq.core.domain.plugin.PluginStatusType status)
                           throws Exception

Description copied from interface: ServerPluginManagerLocal

Sets the status flag in the database but does NOT restart the server plugin container. If the status is PluginStatusType.DELETED, the enabled flag is also flipped to false. This has "requires new" semantics, so the results are committed immediately upon return.

Specified by:

setServerPluginStatus in interface ServerPluginManagerLocal

Parameters:

subject - user making the request

pluginIds - the plugins to be enabled

Throws:

Exception

registerServerPlugin

public org.rhq.core.domain.plugin.ServerPlugin registerServerPlugin(org.rhq.core.domain.auth.Subject subject,
                                                           org.rhq.core.domain.plugin.ServerPlugin plugin,
                                                           File pluginFile)
                                                             throws Exception

Description copied from interface: ServerPluginManagerLocal

Registers the given plugin to the database. This ensures the database is up-to-date with the new plugin details. If the master plugin container is up, it will attempt to restart the plugin so the new changes are picked up.

Specified by:

registerServerPlugin in interface ServerPluginManagerLocal

Parameters:

subject - the user that needs to have permissions to add a plugin to the system

plugin - the plugin definition

pluginFile - the actual plugin file itself

Returns:

the plugin after being persisted

Throws:

Exception - if failed to fully register the plugin

purgeServerPlugin

public void purgeServerPlugin(int pluginId)

Description copied from interface: ServerPluginManagerLocal

Purges the server plugin from the database. This ensures that, after this method returns, the given plugin will be unknown. The plugin can be installed again later. This has "requires new" semantics, so the results are committed immediately upon return.

Do not invoke this method directly. It is meant as a support for PurgePluginsJob.

Specified by:

purgeServerPlugin in interface ServerPluginManagerLocal

Parameters:

pluginId - the id of the server plugin to delete

updateServerPluginExceptContent

public org.rhq.core.domain.plugin.ServerPlugin updateServerPluginExceptContent(org.rhq.core.domain.auth.Subject subject,
                                                                      org.rhq.core.domain.plugin.ServerPlugin plugin)
                                                                        throws Exception

Description copied from interface: ServerPluginManagerLocal

Given a plugin that already exists, this will update that plugin's data in the database, except for the content, which is left as-is. If the plugin did not yet exist, an exception is thrown. You can use this to update the plugin's scheduled jobs configuration and plugin configuration.

Specified by:

updateServerPluginExceptContent in interface ServerPluginManagerLocal

Parameters:

subject - user making the request

plugin - existing plugin with updated data

Returns:

the updated plugin

Throws:

Exception - if the plugin did not already exist or an error occurred that caused the update to fail

getServerPluginStatus

public org.rhq.core.domain.plugin.PluginStatusType getServerPluginStatus(org.rhq.core.domain.plugin.PluginKey pluginKey)

Description copied from interface: ServerPluginManagerLocal

Given the key of a server plugin, this will return the status of that plugin. Use this to determine if a plugin has been deleted or not.

Specified by:

getServerPluginStatus in interface ServerPluginManagerLocal

Parameters:

pluginKey - the key of the plugin whose status is to be returned.

Returns:

the status of the plugin, to indicate if the plugin has been deleted or is installed. null indicates an unknown plugin.

getInstalledServerPluginsGroupedByType

public Map<ServerPluginType,List<org.rhq.core.domain.plugin.PluginKey>> getInstalledServerPluginsGroupedByType()

Description copied from interface: ServerPluginManagerLocal

This will return a map containing all installed plugins that are both enabled and disabled.

Specified by:

getInstalledServerPluginsGroupedByType in interface ServerPluginManagerLocal

Returns:

keys of all enabled and disabled plugins, keyed on their types

getServerPluginConfigurationDefinition

public org.rhq.core.domain.configuration.definition.ConfigurationDefinition getServerPluginConfigurationDefinition(org.rhq.core.domain.plugin.PluginKey pluginKey)
                                                                                                            throws Exception

Description copied from interface: ServerPluginManagerLocal

Returns the definition for the given plugin's global plugin configuration.

Specified by:

getServerPluginConfigurationDefinition in interface ServerPluginManagerLocal

Returns:

the plugin configuration definition

Throws:

Exception

getServerPluginScheduledJobsDefinition

public org.rhq.core.domain.configuration.definition.ConfigurationDefinition getServerPluginScheduledJobsDefinition(org.rhq.core.domain.plugin.PluginKey pluginKey)
                                                                                                            throws Exception

Description copied from interface: ServerPluginManagerLocal

Returns the definition for the given plugin's scheduled jobs configuration.

Specified by:

getServerPluginScheduledJobsDefinition in interface ServerPluginManagerLocal

Returns:

the scheduled jobs definition

Throws:

Exception

getServerPluginControlDefinitions

public List<ControlDefinition> getServerPluginControlDefinitions(org.rhq.core.domain.plugin.PluginKey pluginKey)
                                                          throws Exception

Description copied from interface: ServerPluginManagerLocal

Returns the metadata for all control operations for the given plugin. If there are no control operations, an empty list is returned.

Specified by:

getServerPluginControlDefinitions in interface ServerPluginManagerLocal

Returns:

list of control definitions that are defined for the given plugin

Throws:

Exception - if failed to determine a plugin's control definitions

invokeServerPluginControl

public ControlResults invokeServerPluginControl(org.rhq.core.domain.auth.Subject subject,
                                       org.rhq.core.domain.plugin.PluginKey pluginKey,
                                       String controlName,
                                       org.rhq.core.domain.configuration.Configuration params)
                                         throws Exception

Description copied from interface: ServerPluginManagerRemote

Invokes a control operation on a given plugin and returns the results. This method blocks until the plugin component completes the invocation.

Specified by:

invokeServerPluginControl in interface ServerPluginManagerRemote

Parameters:

subject - user making the request, must have the proper permissions

pluginKey - identifies the plugin whose control operation is to be invoked

controlName - identifies the name of the control operation to invoke

params - parameters to pass to the control operation; may be null

Returns:

the results of the invocation

Throws:

Exception

isReadyForPurge

public boolean isReadyForPurge(int pluginId)

Description copied from interface: ServerPluginManagerLocal

A helper method for PurgePluginsJob. Checks whether given server plugin is safe for purging from the database.

Specified by:

isReadyForPurge in interface ServerPluginManagerLocal

acknowledgeDeletedPluginsBy

public void acknowledgeDeletedPluginsBy(int serverId)

Description copied from interface: ServerPluginManagerLocal

The provided server acknowledges the deletion of all plugins marked as deleted by calling this method. Once all the servers in the HA cloud acknowledge the deletion of a plugin and the plugin is made purgable (after its resource types are deleted, etc) it will be automatically purged from the database.

This method is not meant for "public" consumption and is only called from ServerPluginScanner

Specified by:

acknowledgeDeletedPluginsBy in interface ServerPluginManagerLocal

Parameters:

serverId - the id of the server that wants to acknowledge that it has seen the deleted plugins

getServerPlugins

public List<org.rhq.core.domain.plugin.ServerPlugin> getServerPlugins(org.rhq.core.domain.auth.Subject subject)

Description copied from interface: ServerPluginManagerRemote

Returns a list of all the installed server plugins in the database, minus the content object.

Specified by:

getServerPlugins in interface ServerPluginManagerRemote

Returns:

all installed server plugins found in the DB