org.rhq.enterprise.server.configuration

Interface ConfigurationManagerRemote

All Known Subinterfaces:

ConfigurationManagerLocal

All Known Implementing Classes:

ConfigurationManagerBean

public interface ConfigurationManagerRemote

The configuration manager which allows you to request resource configuration changes, view current resource configuration and previous update history and view/edit plugin configuration.

Author:

John Mazzitelli, Ian Springer

Method Summary

Methods

Modifier and Type	Method and Description
org.rhq.core.domain.util.PageList<org.rhq.core.domain.configuration.group.GroupPluginConfigurationUpdate>	findGroupPluginConfigurationUpdatesByCriteria(org.rhq.core.domain.auth.Subject subject, org.rhq.core.domain.criteria.GroupPluginConfigurationUpdateCriteria criteria)
org.rhq.core.domain.util.PageList<org.rhq.core.domain.configuration.group.GroupResourceConfigurationUpdate>	findGroupResourceConfigurationUpdatesByCriteria(org.rhq.core.domain.auth.Subject subject, org.rhq.core.domain.criteria.GroupResourceConfigurationUpdateCriteria criteria)
org.rhq.core.domain.configuration.group.GroupPluginConfigurationUpdate	getGroupPluginConfigurationUpdate(org.rhq.core.domain.auth.Subject subject, int configurationUpdateId) Deprecated. use findGroupPluginConfigurationUpdatesByCriteria(org.rhq.core.domain.auth.Subject, org.rhq.core.domain.criteria.GroupPluginConfigurationUpdateCriteria)
org.rhq.core.domain.configuration.group.GroupResourceConfigurationUpdate	getGroupResourceConfigurationUpdate(org.rhq.core.domain.auth.Subject subject, int configurationUpdateId) Deprecated. use findGroupResourceConfigurationUpdatesByCriteria(org.rhq.core.domain.auth.Subject, org.rhq.core.domain.criteria.GroupResourceConfigurationUpdateCriteria)
org.rhq.core.domain.configuration.PluginConfigurationUpdate	getLatestPluginConfigurationUpdate(org.rhq.core.domain.auth.Subject subject, int resourceId)
org.rhq.core.domain.configuration.ResourceConfigurationUpdate	getLatestResourceConfigurationUpdate(org.rhq.core.domain.auth.Subject subject, int resourceId)
org.rhq.core.domain.configuration.Configuration	getLiveResourceConfiguration(org.rhq.core.domain.auth.Subject subject, int resourceId, boolean pingAgentFirst) Get the currently live resource configuration for the Resource with the given id.
org.rhq.core.domain.configuration.definition.ConfigurationDefinition	getPackageTypeConfigurationDefinition(org.rhq.core.domain.auth.Subject subject, int packageTypeId) Return the deploy configuration definition for the PackageType with the specified id.
org.rhq.core.domain.configuration.Configuration	getPluginConfiguration(org.rhq.core.domain.auth.Subject subject, int resourceId) Get the current plugin configuration for the Resource with the given id, or null if the resource's plugin configuration is not yet initialized.
org.rhq.core.domain.configuration.definition.ConfigurationDefinition	getPluginConfigurationDefinitionForResourceType(org.rhq.core.domain.auth.Subject subject, int resourceTypeId) Return the plugin configuration definition for the ResourceType with the specified id.
org.rhq.core.domain.configuration.Configuration	getResourceConfiguration(org.rhq.core.domain.auth.Subject subject, int resourceId) Get the current Resource configuration.
org.rhq.core.domain.configuration.definition.ConfigurationDefinition	getResourceConfigurationDefinitionForResourceType(org.rhq.core.domain.auth.Subject subject, int resourceTypeId) Return the resource configuration definition for the ResourceType with the specified id.
org.rhq.core.domain.configuration.definition.ConfigurationDefinition	getResourceConfigurationDefinitionWithTemplatesForResourceType(org.rhq.core.domain.auth.Subject subject, int resourceTypeId) Return the resource configuration definition for the ResourceType with the specified id.
boolean	isGroupResourceConfigurationUpdateInProgress(org.rhq.core.domain.auth.Subject subject, int resourceGroupId)
boolean	isResourceConfigurationUpdateInProgress(org.rhq.core.domain.auth.Subject subject, int resourceId) Get whether the the specified resource is in the process of updating its configuration.
int	scheduleGroupPluginConfigurationUpdate(org.rhq.core.domain.auth.Subject subject, int compatibleGroupId, Map<Integer,org.rhq.core.domain.configuration.Configuration> pluginConfigurationUpdate) Schedules jobs to update the plugin configuration of resources in a compatible group.
int	scheduleGroupResourceConfigurationUpdate(org.rhq.core.domain.auth.Subject subject, int compatibleGroupId, Map<Integer,org.rhq.core.domain.configuration.Configuration> newResourceConfigurationMap)
org.rhq.core.domain.configuration.Configuration	translateResourceConfiguration(org.rhq.core.domain.auth.Subject subject, int resourceId, org.rhq.core.domain.configuration.Configuration configuration, boolean fromStructured) Deprecated. this feature was never full implemented and will be removed.
org.rhq.core.domain.configuration.PluginConfigurationUpdate	updatePluginConfiguration(org.rhq.core.domain.auth.Subject subject, int resourceId, org.rhq.core.domain.configuration.Configuration newConfiguration) Updates the plugin configuration used to connect and communicate with the resource.
org.rhq.core.domain.configuration.ResourceConfigurationUpdate	updateResourceConfiguration(org.rhq.core.domain.auth.Subject subject, int resourceId, org.rhq.core.domain.configuration.Configuration newConfiguration) This method is called when a user has requested to change the resource configuration for an existing resource.

Method Detail

findGroupPluginConfigurationUpdatesByCriteria

org.rhq.core.domain.util.PageList<org.rhq.core.domain.configuration.group.GroupPluginConfigurationUpdate> findGroupPluginConfigurationUpdatesByCriteria(org.rhq.core.domain.auth.Subject subject,
                                                                                                                                                      org.rhq.core.domain.criteria.GroupPluginConfigurationUpdateCriteria criteria)

Parameters:

subject -

criteria -

Returns:

not null

Since:

4.10

findGroupResourceConfigurationUpdatesByCriteria

org.rhq.core.domain.util.PageList<org.rhq.core.domain.configuration.group.GroupResourceConfigurationUpdate> findGroupResourceConfigurationUpdatesByCriteria(org.rhq.core.domain.auth.Subject subject,
                                                                                                                                                          org.rhq.core.domain.criteria.GroupResourceConfigurationUpdateCriteria criteria)

Parameters:

subject -

criteria -

Returns:

not null

Since:

4.10

getGroupPluginConfigurationUpdate

@Deprecated
org.rhq.core.domain.configuration.group.GroupPluginConfigurationUpdate getGroupPluginConfigurationUpdate(org.rhq.core.domain.auth.Subject subject,
                                                                                                                  int configurationUpdateId)

Deprecated. use findGroupPluginConfigurationUpdatesByCriteria(org.rhq.core.domain.auth.Subject, org.rhq.core.domain.criteria.GroupPluginConfigurationUpdateCriteria)

Parameters:

subject -

configurationUpdateId -

Returns:

object

getGroupResourceConfigurationUpdate

@Deprecated
org.rhq.core.domain.configuration.group.GroupResourceConfigurationUpdate getGroupResourceConfigurationUpdate(org.rhq.core.domain.auth.Subject subject,
                                                                                                                      int configurationUpdateId)

Deprecated. use findGroupResourceConfigurationUpdatesByCriteria(org.rhq.core.domain.auth.Subject, org.rhq.core.domain.criteria.GroupResourceConfigurationUpdateCriteria)

Parameters:

subject -

configurationUpdateId -

Returns:

object

getPluginConfiguration

org.rhq.core.domain.configuration.Configuration getPluginConfiguration(org.rhq.core.domain.auth.Subject subject,
                                                                     int resourceId)

Get the current plugin configuration for the Resource with the given id, or null if the resource's plugin configuration is not yet initialized.

Parameters:

subject - the user who wants to see the information

resourceId - a Resource id

Returns:

the current plugin configuration for the Resource with the given id, or null if the resource's configuration is not yet initialized

getResourceConfiguration

org.rhq.core.domain.configuration.Configuration getResourceConfiguration(org.rhq.core.domain.auth.Subject subject,
                                                                       int resourceId)

Get the current Resource configuration.

Parameters:

subject - The logged in user's subject.

resourceId - A resource id.

Returns:

The specified configuration or null

getLatestPluginConfigurationUpdate

org.rhq.core.domain.configuration.PluginConfigurationUpdate getLatestPluginConfigurationUpdate(org.rhq.core.domain.auth.Subject subject,
                                                                                             int resourceId)

Parameters:

subject -

resourceId -

Returns:

the most recent plugin configuration update

getLatestResourceConfigurationUpdate

org.rhq.core.domain.configuration.ResourceConfigurationUpdate getLatestResourceConfigurationUpdate(org.rhq.core.domain.auth.Subject subject,
                                                                                                 int resourceId)

Parameters:

subject -

resourceId -

Returns:

the most recent resource configuration update

isResourceConfigurationUpdateInProgress

boolean isResourceConfigurationUpdateInProgress(org.rhq.core.domain.auth.Subject subject,
                                              int resourceId)

Get whether the the specified resource is in the process of updating its configuration.

Parameters:

subject - The logged in user's subject.

resourceId - A resource id.

Returns:

True if in progress, else False.

isGroupResourceConfigurationUpdateInProgress

boolean isGroupResourceConfigurationUpdateInProgress(org.rhq.core.domain.auth.Subject subject,
                                                   int resourceGroupId)

Parameters:

subject -

resourceGroupId -

Returns:

True if in progress, else False

scheduleGroupPluginConfigurationUpdate

int scheduleGroupPluginConfigurationUpdate(org.rhq.core.domain.auth.Subject subject,
                                         int compatibleGroupId,
                                         Map<Integer,org.rhq.core.domain.configuration.Configuration> pluginConfigurationUpdate)

Schedules jobs to update the plugin configuration of resources in a compatible group.

Parameters:

subject - logged in user

compatibleGroupId - the compatible group id

pluginConfigurationUpdate - Configuration objects mapped by resource id

Returns:

the GroupPluginConfigurationUpdate id

scheduleGroupResourceConfigurationUpdate

int scheduleGroupResourceConfigurationUpdate(org.rhq.core.domain.auth.Subject subject,
                                           int compatibleGroupId,
                                           Map<Integer,org.rhq.core.domain.configuration.Configuration> newResourceConfigurationMap)

Parameters:

subject -

compatibleGroupId -

newResourceConfigurationMap -

Returns:

GroupResourceConfigurationUpdate id

updatePluginConfiguration

org.rhq.core.domain.configuration.PluginConfigurationUpdate updatePluginConfiguration(org.rhq.core.domain.auth.Subject subject,
                                                                                    int resourceId,
                                                                                    org.rhq.core.domain.configuration.Configuration newConfiguration)
                                                                                      throws ResourceNotFoundException

Updates the plugin configuration used to connect and communicate with the resource. The given newConfiguration is usually a modified version of a configuration returned by getPluginConfiguration(Subject, int).

Parameters:

subject - The logged in user's subject.

resourceId - a Resource id

newConfiguration - the new plugin configuration

Returns:

the plugin configuration update item corresponding to this request

Throws:

ResourceNotFoundException

updateResourceConfiguration

org.rhq.core.domain.configuration.ResourceConfigurationUpdate updateResourceConfiguration(org.rhq.core.domain.auth.Subject subject,
                                                                                        int resourceId,
                                                                                        org.rhq.core.domain.configuration.Configuration newConfiguration)
                                                                                          throws ResourceNotFoundException,
                                                                                                 ConfigurationUpdateStillInProgressException

This method is called when a user has requested to change the resource configuration for an existing resource. If the user does not have the proper permissions to change the resource's configuration, an exception is thrown.

This will not wait for the agent to finish the configuration update. This will return after the request is sent.

Parameters:

subject - The logged in user's subject.

resourceId - identifies the resource to be updated

newConfiguration - the resource's desired new configuration

Returns:

the resource configuration update item corresponding to this request

Throws:

ResourceNotFoundException

ConfigurationUpdateStillInProgressException

getLiveResourceConfiguration

org.rhq.core.domain.configuration.Configuration getLiveResourceConfiguration(org.rhq.core.domain.auth.Subject subject,
                                                                           int resourceId,
                                                                           boolean pingAgentFirst)
                                                                             throws Exception

Get the currently live resource configuration for the Resource with the given id. This actually asks for the up-to-date configuration directly from the agent. An exception will be thrown if communications with the agent cannot be made.

Parameters:

subject - The logged in user's subject.

resourceId - resourceId

pingAgentFirst -

Returns:

the live configuration

Throws:

Exception - if failed to get the configuration from the agent

getResourceConfigurationDefinitionForResourceType

org.rhq.core.domain.configuration.definition.ConfigurationDefinition getResourceConfigurationDefinitionForResourceType(org.rhq.core.domain.auth.Subject subject,
                                                                                                                     int resourceTypeId)

Return the resource configuration definition for the ResourceType with the specified id.

Parameters:

subject - the user who is requesting the resource configuration definition

resourceTypeId - identifies the resource type whose resource configuration definition is being requested

Returns:

the resource configuration definition for the ResourceType with the specified id, or null if the ResourceType does not define a resource configuration

getResourceConfigurationDefinitionWithTemplatesForResourceType

org.rhq.core.domain.configuration.definition.ConfigurationDefinition getResourceConfigurationDefinitionWithTemplatesForResourceType(org.rhq.core.domain.auth.Subject subject,
                                                                                                                                  int resourceTypeId)

Return the resource configuration definition for the ResourceType with the specified id. The templates will be loaded in the definition returned from this call.

Parameters:

subject - the user who is requesting the resource configuration definition

resourceTypeId - identifies the resource type whose resource configuration definition is being requested

Returns:

the resource configuration definition for the ResourceType with the specified id, or null if the ResourceType does not define a resource configuration

getPluginConfigurationDefinitionForResourceType

org.rhq.core.domain.configuration.definition.ConfigurationDefinition getPluginConfigurationDefinitionForResourceType(org.rhq.core.domain.auth.Subject subject,
                                                                                                                   int resourceTypeId)

Return the plugin configuration definition for the ResourceType with the specified id.

Parameters:

subject - the user who is requesting the plugin configuration definition

resourceTypeId - identifies the resource type whose plugin configuration definition is being requested

Returns:

the plugin configuration definition for the ResourceType with the specified id, or null if the ResourceType does not define a plugin configuration

getPackageTypeConfigurationDefinition

org.rhq.core.domain.configuration.definition.ConfigurationDefinition getPackageTypeConfigurationDefinition(org.rhq.core.domain.auth.Subject subject,
                                                                                                         int packageTypeId)

Return the deploy configuration definition for the PackageType with the specified id.

Parameters:

subject - the user who is requesting the plugin configuration definition

packageTypeId - identifies the package type whose configuration definition is being requested

Returns:

the the deploy configuration definition for the PackageType with the specified id.

translateResourceConfiguration

@Deprecated
org.rhq.core.domain.configuration.Configuration translateResourceConfiguration(org.rhq.core.domain.auth.Subject subject,
                                                                                        int resourceId,
                                                                                        org.rhq.core.domain.configuration.Configuration configuration,
                                                                                        boolean fromStructured)
                                                                               throws ResourceNotFoundException

Deprecated. this feature was never full implemented and will be removed.

Parameters:

subject -

resourceId -

configuration -

fromStructured -

Returns:

the translated configuration

Throws:

ResourceNotFoundException