org.rhq.enterprise.server.system

Interface SystemManagerLocal

All Superinterfaces:

SystemManagerRemote

All Known Implementing Classes:

SystemManagerBean

public interface SystemManagerLocal
extends SystemManagerRemote

Provides access to the server cloud's system configuration as well as some methods to perform configuration on the server in which this bean is running.

Method Summary

Methods

Modifier and Type	Method and Description
long	analyze(org.rhq.core.domain.auth.Subject whoami) Run analyze command on PostgreSQL databases.
void	dumpSystemInfo(org.rhq.core.domain.auth.Subject subject)
void	enableHibernateStatistics() Creates and registers the Hibernate Statistics MBean.
DatabaseType	getDatabaseType() Returns the DatabaseType that corresponds to the database the JON Server uses for its backend.
boolean	isDebugModeEnabled()
boolean	isExperimentalFeaturesEnabled()
boolean	isLdapAuthorizationEnabled()
void	loadSystemConfigurationCache() Grabs the current system configuration from the database and reloads the cache with it.
void	loadSystemConfigurationCacheInNewTx() Grabs the current system configuration from the database and reloads the cache with it.
void	reconfigureSystem(org.rhq.core.domain.auth.Subject whoami) Performs some reconfiguration things on the server where we are running.
long	reindex(org.rhq.core.domain.auth.Subject whoami) Reindexes all tables that need to be periodically reindexed.
void	scheduleConfigCacheReloader() Schedules the internal timer job that periodically refreshes the configuration cache.
void	setStorageClusterSettings(org.rhq.core.domain.auth.Subject subject, org.rhq.core.domain.common.composite.SystemSettings settings) The storage cluster settings are stored as read-only system settings.
void	undeployInstaller() Deprecated.
long	vacuum(org.rhq.core.domain.auth.Subject whoami) Run database-specific cleanup routines.
long	vacuum(org.rhq.core.domain.auth.Subject whoami, String[] tableNames) Run database-specific cleanup routines for the given tables.
long	vacuumAppdef(org.rhq.core.domain.auth.Subject whoami) Run database-specific cleanup routines on appdef tables.
void	validateSystemConfiguration(org.rhq.core.domain.auth.Subject subject, Properties properties)

Methods inherited from interface org.rhq.enterprise.server.system.SystemManagerRemote

getProductInfo, getServerDetails, getSystemConfiguration, getSystemSettings, setSystemConfiguration, setSystemSettings

Method Detail

getDatabaseType

DatabaseType getDatabaseType()

Returns the DatabaseType that corresponds to the database the JON Server uses for its backend.

This method is mainly to allow the caller to determine the kind of database in use so as to determine what syntax to use for a particular native query.

Returns:

the type of database

scheduleConfigCacheReloader

void scheduleConfigCacheReloader()

Schedules the internal timer job that periodically refreshes the configuration cache. This is needed in case a user changed the system configuration on another server in the HA cloud - this config cache reloader will load in that new configuration.

enableHibernateStatistics

void enableHibernateStatistics()

Creates and registers the Hibernate Statistics MBean. This allows us to monitor our own Hibernate usage.

reconfigureSystem

void reconfigureSystem(org.rhq.core.domain.auth.Subject whoami)

Performs some reconfiguration things on the server where we are running. This includes redeploying the configured JAAS modules.

analyze

long analyze(org.rhq.core.domain.auth.Subject whoami)

Run analyze command on PostgreSQL databases. On non-PostgreSQL, this returns -1.

Parameters:

whoami - the user requesting the operation

Returns:

The time it took to analyze, in milliseconds, or -1 if the database is not PostgreSQL.

reindex

long reindex(org.rhq.core.domain.auth.Subject whoami)

Reindexes all tables that need to be periodically reindexed. For Oracle, this "rebuilds" the indexes, for PostgreSQL, its a "reindex".

Parameters:

whoami - the user requesting the operation

Returns:

The time it took to reindex, in milliseconds

vacuum

long vacuum(org.rhq.core.domain.auth.Subject whoami)

Run database-specific cleanup routines. On PostgreSQL we do a VACUUM ANALYZE on all tables. On other databases we just return -1.

Parameters:

whoami - the user requesting the operation

Returns:

The time it took to vaccum, in milliseconds, or -1 if the database is not PostgreSQL.

vacuum

long vacuum(org.rhq.core.domain.auth.Subject whoami,
          String[] tableNames)

Run database-specific cleanup routines for the given tables. On PostgreSQL we do a VACUUM ANALYZE on the given tables. On other databases we just return -1.

Parameters:

whoami - the user requesting the operation

tableNames - names of specific tables that will be vacuumed.

Returns:

The time it took to vaccum, in milliseconds, or -1 if the database is not PostgreSQL.

vacuumAppdef

long vacuumAppdef(org.rhq.core.domain.auth.Subject whoami)

Run database-specific cleanup routines on appdef tables. On PostgreSQL we do a VACUUM ANALYZE against the relevant tables. On other databases we just return -1.

Parameters:

whoami - the user requesting the operation

Returns:

The time it took to vaccum, in milliseconds, or -1 if the database is not PostgreSQL.

undeployInstaller

@Deprecated
void undeployInstaller()

Deprecated.

Ensures the installer has been undeployed. Installer must be undeployed to ensure the server deployment is secure.

loadSystemConfigurationCacheInNewTx

void loadSystemConfigurationCacheInNewTx()

Grabs the current system configuration from the database and reloads the cache with it. This is meant for internal use only! You probably want to use #getSystemConfiguration() instead.

loadSystemConfigurationCache

void loadSystemConfigurationCache()

Grabs the current system configuration from the database and reloads the cache with it. This is meant for internal use only! You probably want to use #getSystemConfiguration() instead.

isDebugModeEnabled

boolean isDebugModeEnabled()

isExperimentalFeaturesEnabled

boolean isExperimentalFeaturesEnabled()

isLdapAuthorizationEnabled

boolean isLdapAuthorizationEnabled()

validateSystemConfiguration

void validateSystemConfiguration(org.rhq.core.domain.auth.Subject subject,
                               Properties properties)
                                 throws InvalidSystemConfigurationException

Throws:

InvalidSystemConfigurationException

dumpSystemInfo

void dumpSystemInfo(org.rhq.core.domain.auth.Subject subject)

setStorageClusterSettings

void setStorageClusterSettings(org.rhq.core.domain.auth.Subject subject,
                             org.rhq.core.domain.common.composite.SystemSettings settings)

The storage cluster settings are stored as read-only system settings. They should be updated through the storage subsystem. This API is provided for use ONLY by the storage subsystem.

Parameters:

subject - The user who wants to change the settings

settings - The new storage cluster settings

Throws:

IllegalArgumentException - If the settings contain anything other than storage cluster settings.