org.rhq.enterprise.server.discovery

Interface DiscoveryBossLocal

All Superinterfaces:

DiscoveryBossRemote

All Known Implementing Classes:

DiscoveryBossBean

public interface DiscoveryBossLocal
extends DiscoveryBossRemote

The boss interface to the discovery subsystem.

Method Summary

Methods

Modifier and Type	Method and Description
org.rhq.core.domain.discovery.MergeResourceResponse	addResource(org.rhq.core.domain.resource.Resource resource, int ownerSubjectId) Adds the specified resource to inventory, *auto-committing it*.
List<org.rhq.core.domain.resource.Resource>	getQueuedPlatformChildServers(org.rhq.core.domain.auth.Subject user, org.rhq.core.domain.resource.InventoryStatus status, org.rhq.core.domain.resource.Resource platform) Given a platform resource, this returns all of its child server resources that have been auto-discovered and have the given status.
org.rhq.core.domain.util.PageList<org.rhq.core.domain.resource.Resource>	getQueuedPlatforms(org.rhq.core.domain.auth.Subject user, EnumSet<org.rhq.core.domain.resource.InventoryStatus> statuses, org.rhq.core.domain.util.PageControl pc) This returns all platform resources that either have the given status themselves or one or more of their child servers have that status.
Map<org.rhq.core.domain.resource.Resource,List<org.rhq.core.domain.resource.Resource>>	getQueuedPlatformsAndServers(org.rhq.core.domain.auth.Subject user, EnumSet<org.rhq.core.domain.resource.InventoryStatus> statuses, org.rhq.core.domain.util.PageControl pc) Like the above method, but can find ignored, commited or both
Map<org.rhq.core.domain.resource.Resource,List<org.rhq.core.domain.resource.Resource>>	getQueuedPlatformsAndServers(org.rhq.core.domain.auth.Subject user, org.rhq.core.domain.util.PageControl pc) Returns a map of platforms (the keys) and their servers (the values) that are in the auto-discovery queue but not yet imported into inventory.
org.rhq.core.domain.discovery.ResourceSyncInfo	getResourceSyncInfo(org.rhq.core.domain.resource.Agent knownAgent)
org.rhq.core.domain.discovery.MergeResourceResponse	manuallyAddResource(org.rhq.core.domain.auth.Subject user, org.rhq.core.domain.resource.ResourceType resourceType, int parentResourceId, org.rhq.core.domain.configuration.Configuration pluginConfiguration) Manually add the resource of the specified type to inventory using the specified plugin configuration (i.e.
org.rhq.core.domain.discovery.ResourceSyncInfo	mergeInventoryReport(InventoryReport report) When agents send up results from their discovery components (which notifies the server about newly discovered resources), this method will eventually be called in order to process those inventory reports.
void	mergeResourceInNewTransaction(List<org.rhq.core.domain.resource.Resource> resourceBatch, org.rhq.core.domain.resource.Agent agent) Exists for transactional boundary reasons only.
void	updateAgentInventoryStatus(String platformsList, String serversList)
void	updateInventoryStatus(org.rhq.core.domain.auth.Subject user, org.rhq.core.domain.resource.InventoryStatus status, List<org.rhq.core.domain.resource.Resource> platforms, List<org.rhq.core.domain.resource.Resource> servers) This is used internally.
void	updateInventoryStatus(org.rhq.core.domain.auth.Subject user, List<org.rhq.core.domain.resource.Resource> platforms, List<org.rhq.core.domain.resource.Resource> servers, org.rhq.core.domain.resource.InventoryStatus status) This method is used to change the inventory status of a set of platforms and servers (e.g.
boolean	updateResourceVersion(int resourceId, String version) Updates the version of the specified Resource in inventory, if it is indeed in inventory.
Set<ResourceUpgradeResponse>	upgradeResources(Set<ResourceUpgradeRequest> upgradeRequests) Upgrades the data of the resources according to the provided reports.

Methods inherited from interface org.rhq.enterprise.server.discovery.DiscoveryBossRemote

ignoreResources, importResources, manuallyAddResource, unignoreResources

Method Detail

mergeInventoryReport

org.rhq.core.domain.discovery.ResourceSyncInfo mergeInventoryReport(InventoryReport report)
                                                                    throws InvalidInventoryReportException

When agents send up results from their discovery components (which notifies the server about newly discovered resources), this method will eventually be called in order to process those inventory reports.

Parameters:

report - the inventory report to be merged

Returns:

the server's response, which will include the true IDs for new resources that were found

Throws:

InvalidInventoryReportException - if the inventory report is invalid

mergeResourceInNewTransaction

void mergeResourceInNewTransaction(List<org.rhq.core.domain.resource.Resource> resourceBatch,
                                 org.rhq.core.domain.resource.Agent agent)
                                   throws InvalidInventoryReportException

Exists for transactional boundary reasons only.

Merge In the provided batch of resources. The list of resources must provide a parent before its child.

Parameters:

resourceBatch -

agent -

Throws:

InvalidInventoryReportException

getResourceSyncInfo

org.rhq.core.domain.discovery.ResourceSyncInfo getResourceSyncInfo(org.rhq.core.domain.resource.Agent knownAgent)

Parameters:

knownAgent - the agent for the platform we want to sync with

Returns:

null if platform not found

getQueuedPlatformsAndServers

Map<org.rhq.core.domain.resource.Resource,List<org.rhq.core.domain.resource.Resource>> getQueuedPlatformsAndServers(org.rhq.core.domain.auth.Subject user,
                                                                                                                  org.rhq.core.domain.util.PageControl pc)

Returns a map of platforms (the keys) and their servers (the values) that are in the auto-discovery queue but not yet imported into inventory. Note that only servers whose direct parent is the platform will appear in the returned data. Embedded servers (i.e. servers that are children of other servers) will be automatically imported when you import their parent server.

Parameters:

user - the user that wants to see the data

pc - used to define the size of the returned map - will determine how many platforms are returned

Returns:

the platforms and servers that need to be imported or ignored

getQueuedPlatformsAndServers

Map<org.rhq.core.domain.resource.Resource,List<org.rhq.core.domain.resource.Resource>> getQueuedPlatformsAndServers(org.rhq.core.domain.auth.Subject user,
                                                                                                                  EnumSet<org.rhq.core.domain.resource.InventoryStatus> statuses,
                                                                                                                  org.rhq.core.domain.util.PageControl pc)

Like the above method, but can find ignored, commited or both

Parameters:

user - the subject

statuses - the inventory status'

pc - page control

Returns:

the queued platforms and servers

getQueuedPlatforms

org.rhq.core.domain.util.PageList<org.rhq.core.domain.resource.Resource> getQueuedPlatforms(org.rhq.core.domain.auth.Subject user,
                                                                                          EnumSet<org.rhq.core.domain.resource.InventoryStatus> statuses,
                                                                                          org.rhq.core.domain.util.PageControl pc)

This returns all platform resources that either have the given status themselves or one or more of their child servers have that status. Use this to find those platforms that need to be shown in the auto-discovery pages (i.e. those that need to be committed to inventory). Can use this to find platforms that have servers that are ignored.

Parameters:

user - the user that wants to see the data

statuses - the statuses that platform or its child servers must have

pc - pagination controls

Returns:

the platforms

See Also:

getQueuedPlatformChildServers(org.rhq.core.domain.auth.Subject, org.rhq.core.domain.resource.InventoryStatus, org.rhq.core.domain.resource.Resource)

getQueuedPlatformChildServers

List<org.rhq.core.domain.resource.Resource> getQueuedPlatformChildServers(org.rhq.core.domain.auth.Subject user,
                                                                        org.rhq.core.domain.resource.InventoryStatus status,
                                                                        org.rhq.core.domain.resource.Resource platform)

Given a platform resource, this returns all of its child server resources that have been auto-discovered and have the given status.

Parameters:

user - the user that wants to see the data

status - the status that platform or its child servers must have

platform - the resource whose auto-discovered child servers must have the given status

Returns:

the give platform's top-level server children that have the given status

updateInventoryStatus

void updateInventoryStatus(org.rhq.core.domain.auth.Subject user,
                         List<org.rhq.core.domain.resource.Resource> platforms,
                         List<org.rhq.core.domain.resource.Resource> servers,
                         org.rhq.core.domain.resource.InventoryStatus status)

This method is used to change the inventory status of a set of platforms and servers (e.g. when users import new resources into inventory).

Parameters:

user - the user that wants to change the status

platforms - identifies the platforms that are to be updated

servers - identifies the servers that are to be updated

status - the new status the given resources will have

updateInventoryStatus

void updateInventoryStatus(org.rhq.core.domain.auth.Subject user,
                         org.rhq.core.domain.resource.InventoryStatus status,
                         List<org.rhq.core.domain.resource.Resource> platforms,
                         List<org.rhq.core.domain.resource.Resource> servers)

This is used internally. Never call this yourself without knowing what you do. See updateInventoryStatus(Subject, List, List, InventoryStatus) for the "public" version.

Parameters:

user - the user that wants to change the status

status - the new status the given resources will have

platforms - identifies the platforms that are to be updated

servers - identifies the servers that are to be updated

manuallyAddResource

@NotNull
org.rhq.core.domain.discovery.MergeResourceResponse manuallyAddResource(org.rhq.core.domain.auth.Subject user,
                                                                              org.rhq.core.domain.resource.ResourceType resourceType,
                                                                              int parentResourceId,
                                                                              org.rhq.core.domain.configuration.Configuration pluginConfiguration)
                                                                        throws InvalidPluginConfigurationClientException,
                                                                               PluginContainerException

Manually add the resource of the specified type to inventory using the specified plugin configuration (i.e. connection properties). This will not only create a new resource, but it will also ensure the resource component is activated (and thus connects to the managed resource). If an error occurs, but the caller can still process the results, the returned object will contain a ResourceError that is associated with the new resource (this occurs when the new resource was created but its component could not be activated).

Parameters:

user - the user that wants to add the resource

resourceType - the type of resource to be manually discovered

parentResourceId - the id of the resource that will be the parent of the manually discovered resource

pluginConfiguration - the properties that should be used to connect to the underlying managed resource

Returns:

NotNull the newly discovered resource with any associated ResourceError that might have occurred during the activation of the resource

Throws:

InvalidPluginConfigurationClientException - if connecting to the underlying managed resource failed due to an invalid plugin configuration

PluginContainerException - if the manual discovery fails for any other reason

addResource

org.rhq.core.domain.discovery.MergeResourceResponse addResource(org.rhq.core.domain.resource.Resource resource,
                                                              int ownerSubjectId)

Adds the specified resource to inventory, *auto-committing it*.

Parameters:

resource - the resource to be merged

ownerSubjectId - the user who should be the owner of the new Resource

Returns:

a response containing the merged resource, as well as whether the resource already existed in inventory

updateResourceVersion

boolean updateResourceVersion(int resourceId,
                            String version)

Updates the version of the specified Resource in inventory, if it is indeed in inventory. If the resource is already in inventory and its version is already version, then this method does nothing and returns true.

Parameters:

resourceId - the id of the Resource to be updated

version - the new version

Returns:

true if the Resource was in inventory and its version is now that of version. false if the Resource was not in inventory

upgradeResources

Set<ResourceUpgradeResponse> upgradeResources(Set<ResourceUpgradeRequest> upgradeRequests)

Upgrades the data of the resources according to the provided reports. The server is free to ignore or modify the requests and will provide the true changes made to the resources on the server-side in the result of this method.

Parameters:

upgradeRequests - contains the information about the upgrade of individual resources.

Returns:

details on what resources have been upgraded with what data.

updateAgentInventoryStatus

void updateAgentInventoryStatus(String platformsList,
                              String serversList)