org.rhq.enterprise.server.system
Interface SystemManagerLocal

All Known Implementing Classes:

SystemManagerBean

public interface SystemManagerLocal

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

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.
org.rhq.core.domain.common.ProductInfo	getProductInfo(org.rhq.core.domain.auth.Subject subject)
org.rhq.core.domain.common.ServerDetails	getServerDetails(org.rhq.core.domain.auth.Subject subject)
Properties	getSystemConfiguration(org.rhq.core.domain.auth.Subject subject) Deprecated.
org.rhq.core.domain.common.composite.SystemSettings	getSystemSettings(org.rhq.core.domain.auth.Subject subject)
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	setSystemConfiguration(org.rhq.core.domain.auth.Subject subject, Properties properties, boolean skipValidation) Deprecated.
void	setSystemSettings(org.rhq.core.domain.auth.Subject subject, org.rhq.core.domain.common.composite.SystemSettings settings)
void	undeployInstaller() Ensures the installer has been undeployed.
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)

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

void undeployInstaller()

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

getProductInfo

org.rhq.core.domain.common.ProductInfo getProductInfo(org.rhq.core.domain.auth.Subject subject)

getServerDetails

org.rhq.core.domain.common.ServerDetails getServerDetails(org.rhq.core.domain.auth.Subject subject)

getSystemSettings

org.rhq.core.domain.common.composite.SystemSettings getSystemSettings(org.rhq.core.domain.auth.Subject subject)

setSystemSettings

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

Throws:

Exception

getSystemConfiguration

@Deprecated
Properties getSystemConfiguration(org.rhq.core.domain.auth.Subject subject)

Deprecated.

setSystemConfiguration

@Deprecated
void setSystemConfiguration(org.rhq.core.domain.auth.Subject subject,
                                       Properties properties,
                                       boolean skipValidation)
                            throws Exception

Deprecated.

Throws:

Exception

dumpSystemInfo

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