com.sun.esb.management.impl.configuration

Class ConfigurationServiceMBeanImpl

java.lang.Object

com.sun.esb.management.base.services.AbstractServiceMBeansImpl

com.sun.esb.management.base.services.AbstractListStateServiceMBeansImpl

com.sun.esb.management.impl.configuration.ConfigurationServiceMBeanImpl

All Implemented Interfaces:

ConfigurationService, Constants, Serializable

public class ConfigurationServiceMBeanImpl
extends AbstractListStateServiceMBeansImpl
implements ConfigurationService, Serializable, Constants

Defines operations for common configuration services across the JBI Runtime, component containers, configuring logger levels, etc.

Author:

graj

See Also:

Serialized Form

Field Summary

Fields inherited from class com.sun.esb.management.base.services.AbstractListStateServiceMBeansImpl

ANY_FRAMEWORK_COMPONENT_STATE, COMPONENT_VERSION_NS, COMPONENT_VERSION_NS_NEW, COMPONENT_VERSION_XPATH_QUERY, FRAMEWORK_SA_ANY_STATE, FRAMEWORK_SA_SHUTDOWN_STATE, FRAMEWORK_SA_STARTED_STATE, FRAMEWORK_SA_STOPPED_STATE, FRAMEWORK_SU_SHUTDOWN_STATE, FRAMEWORK_SU_STARTED_STATE, FRAMEWORK_SU_STOPPED_STATE, FRAMEWORK_SU_UNKNOWN_STATE, SHARED_LIBRARY_VERSION_XPATH_QUERY

Fields inherited from class com.sun.esb.management.base.services.AbstractServiceMBeansImpl

COLON, COMMA, COMPONENT_CONFIG_INSTANCE_ERROR_KEY, componentConfigurationHelper, CUSTOM_ADMINISTRATION_NAME_KEY, CUSTOM_CONFIGURATION_NAME_KEY, CUSTOM_LOGGER_NAME_KEY, CUSTOM_MANAGEMENT_ACTIONS_NAME_KEY, CUSTOM_STATISTICS_NAME_KEY, DOMAIN_TARGET_KEY, EBIJMXDOMAIN, environmentContext, EQUAL, IDENTIFICATION_NAME_KEY, JMX_EBI_DOMAIN, PASSWORD_MASK_CHARACTER, RUNNING_STATE, SERVER_TARGET_KEY, SERVICE_TYPE_KEY, STARTED_STATE

Fields inherited from interface com.sun.jbi.util.Constants

ADMIN_RUNNING_FILE, ADMIN_STOPPED_FILE, CONFIG_NAME_KEY, LOG_LEVEL_DEFAULT, TMP_FOLDER

Constructor Summary

Constructors

Constructor and Description
ConfigurationServiceMBeanImpl(EnvironmentContext anEnvContext) Constructor - Constructs a new instance of ConfigurationServiceMBeanImpl

Method Summary

Methods

Modifier and Type	Method and Description
String	addApplicationConfiguration(String componentName, String targetName, String name, CompositeData appConfig) Add an application configuration.
String	addApplicationConfiguration(String componentName, String targetName, String name, Properties config) Add a named application configuration to a component installed on a given target.
String	addApplicationVariable(String componentName, String targetName, String name, CompositeData appVar) This operation adds a new application variable.
String	addApplicationVariables(String componentName, String targetName, Properties appVariables) Add application variables to a component installed on a given target.
protected String	convertToString(Collection colxn) Convert the objects in the collection to a printable string.
String	deleteApplicationConfiguration(String componentName, String targetName, String name) Delete a named application configuration in a component installed on a given target.
String	deleteApplicationVariables(String componentName, String targetName, String[] appVariableNames) Delete application variables from a component installed on a given target.
String	exportApplicationConfiguration(String applicationName, String targetName, String configDir) This method is used to export the application variables and application configuration objects used by the given application in the specified target.
Properties	getApplicationConfiguration(String componentName, String name, String targetName) Get a specific named configuration.
Map<String,Properties>	getApplicationConfigurations(String componentName, String targetName) Get all the application configurations set on a component.
TabularData	getApplicationConfigurationsAsTabularData(String componentName, String targetName) Get a Map of all application configurations for the component.
protected Map<String,Properties>	getApplicationConfigurationsMap(TabularData td) Convert a application configuration TabularData to a Map keyed by the "configurationName".
Properties	getApplicationVariables(String componentName, String targetName) Get all the application variables set on a component.
TabularData	getApplicationVariablesAsTabularData(String componentName, String targetName) Get the Application Variable set for a component.
Properties	getComponentConfiguration(String componentName, String targetName) Retrieve component configuration
Map<String,Object>	getComponentConfigurationAsMap(String componentName, String targetName) Retrieve component configuration
protected ObjectName	getComponentConfigurationFacadeMBeanName(String componentName, String targetName) Get the component configuration facade MBean name for the target.
protected Properties	getComponentConfigurationForClusteredServer(String componentName, String targetName) Retrieve component configuration for a clustered server (that is up)
Map<String,ObjectName[]>	getComponentExtensionMBeanObjectNames(String componentName, String extensionName, String targetName) Gets the extension MBean object names
ObjectName[]	getComponentExtensionMBeanObjectNames(String componentName, String extensionName, String targetName, String targetInstanceName) Gets the extension MBean object names
Map<String,String>	getComponentLoggerDisplayNames(String componentName, String targetName, String targetInstanceName) Gets the component custom loggers and their display names.
Map<String,Level>	getComponentLoggerLevels(String componentName, String targetName, String targetInstanceName) Gets the component custom loggers and their levels
protected ObjectName	getConfigMBeanName(String componentName, String targetName) Find the actual object config MBean Name -- used by both g/setting component configuations for clustered servers
protected Properties	getConfigurationAttributeValues(ObjectName objectName) Get the config extension MBean attribute values
protected Map<String,Object>	getConfigurationAttributeValuesAsMap(ObjectName objectName) Get the config extension MBean attribute values
ObjectName	getConfigurationMBeanObjectName(String targetName, String configurationType) Get the JBI Runtime Configuration Service MBean Object Name
Properties	getDefaultRuntimeConfiguration() This method returns a tabular data of a complex open data objects that represent the runtime configuration parameter descriptor.
Map<String,Object>	getDefaultRuntimeConfigurationAsMap() This method returns a tabular data of a complex open data objects that represent the runtime configuration parameter descriptor.
Map<String,Object>	getDefaultRuntimeConfigurationAsMapInternal(String targetName) This method returns a tabular data of a complex open data objects that represent the runtime configuration parameter descriptor.
protected Properties	getDefaultRuntimeConfigurationInternal(String targetName) Get the default JBI runtime configuration
protected String	getExistingAppVarType(String compName, String targetName, String appVarName)
protected ObjectName	getExtensionMBeanObjectName(String componentName, String targetName) returns the ObjectName for the Extension Mbean of this component.
ObjectName	getLoggingServiceMBeanObjectName(String targetName) returns the ObjectName for the LoggingService Mbean of this target.
Properties	getRuntimeConfiguration(String targetName) This method returns a tabular data of a complex open data objects that represent the runtime configuration parameter descriptor.
Map<String,Object>	getRuntimeConfigurationAsMap(String targetName) This method returns a tabular data of a complex open data objects that represent the runtime configuration parameter descriptor.
Properties	getRuntimeConfigurationMetaData(String propertyKeyName) This method returns the runtime configuration metadata associated with the specified property.
protected ObjectName	getRuntimeLoggerConfigFacadeMBeanName(String target)
String	getRuntimeLoggerDisplayName(String runtimeLoggerName, String targetName) Return the display name for a runtime logger
String	getRuntimeLoggerDisplayName(String runtimeLoggerName, String targetName, String targetInstanceName) Return the display name for a runtime logger
Level	getRuntimeLoggerLevel(String runtimeLoggerName, String targetName) Lookup the level of one runtime logger
Level	getRuntimeLoggerLevel(String runtimeLoggerName, String targetName, String targetInstanceName) Lookup the level of one runtime logger
Map<String,Level>	getRuntimeLoggerLevels(String targetName) Gets all the runtime loggers and their levels.
Map<String,Level>	getRuntimeLoggerLevels(String targetName, String targetInstanceName) Gets all the runtime loggers and their levels
Map<String,String>	getRuntimeLoggerNames(String targetName) Gets all the runtime loggers and their display names
Map<String,String>	getRuntimeLoggerNames(String targetName, String targetInstanceName) Gets all the runtime loggers and their display names
Object	invokeExtensionMBeanOperation(String componentName, String extensionName, String operationName, Object[] parameters, String[] signature, String targetName, String targetInstanceName) Invokes an operation on an Extension MBean.
boolean	isAppConfigSupported(String componentName, String targetName) Detect the components support for application configuration.
boolean	isAppVarsSupported(String componentName, String targetName) Detect the components support for application variables.
boolean	isComponentConfigSupported(String componentName, String targetName) Detect the components support for component configuration.
boolean	isServerRestartRequired() checks if the server need to be restarted to apply the changes made to some of the configuration parameters.
String[]	listApplicationConfigurationNames(String componentName, String targetName) List all the application configurations in a component.
CompositeType	queryApplicationConfigurationType(String componentName, String targetName) Get the CompositeType definition for the components application configuration
String	retrieveConfigurationDisplayData(String componentName, String targetName) Retrieves the component configuration metadata.
String	retrieveConfigurationDisplaySchema(String componentName, String targetName) Retrieves the component specific configuration schema.
String	setApplicationConfiguration(String componentName, String name, Properties config, String targetName) Update a named application configuration in a component installed on a given target.
String	setApplicationConfiguration(String componentName, String targetName, String name, CompositeData appConfig) Update a application configuration.
String	setApplicationVariable(String componentName, String targetName, String name, CompositeData appVar) This operation sets an application variable.
String	setApplicationVariables(String componentName, Properties appVariables, String targetName) Set application variables on a component installed on a given target.
String	setComponentConfiguration(String componentName, Map<String,Object> configurationValues, String targetName) Will return jbi mgmt message with success, failure, or partial success per instance.
String	setComponentConfiguration(String componentName, Properties configurationValues, String targetName) Set the component static configuration.
void	setComponentLoggerLevel(String componentName, String loggerCustomName, Level logLevel, String targetName, String targetInstanceName) Sets the component log level for a given logger
protected String	setLevel(Level logLevel) Return the "verb" (the setXXX MBean operation) for the given log level
boolean	setRuntimeConfiguration(Map<String,Object> properties, String targetName) This method sets one or more configuration parameters on the runtime with a list of name/value pairs passed as a properties object.
boolean	setRuntimeConfiguration(Properties parameters, String targetName) This method sets one or more configuration parameters on the runtime with a list of name/value pairs passed as a properties object.
protected boolean	setRuntimeConfigurationInternal(Properties properties, String targetName) Set JBI Runtime Configuration
void	setRuntimeLoggerLevel(String runtimeLoggerName, Level logLevel, String targetName) Sets the log level for a given runtime logger
void	setRuntimeLoggerLevel(String runtimeLoggerName, Level logLevel, String targetName, String targetInstanceName) Sets the log level for a given runtime logger
protected void	validateTargetForRuntimeConfigurationSpport(String targetName) validates targetName and throws exception if the target is a clustered instance.
String	verifyApplication(String applicationURL, boolean generateTemplates, String templateDir, boolean includeDeployCommand, String targetName, String clientSAFilePath) This method is used to verify if the application variables and application configuration objects used in the given application are available in JBI runtime in the specified target.

Methods inherited from class com.sun.esb.management.base.services.AbstractListStateServiceMBeansImpl

componentInstalledOnTargetCheck, componentStartedOnTargetCheck, getComponentLifeCycleMBeanObjectName, getComponentNamesDependentOnServiceAssembly, getComponentNamesDependentOnServiceAssembly, getComponentNamesDependentOnSharedLibrary, getComponentNamesDependentOnSharedLibrary, getComponentNamesDependentOnSharedLibraryAndServiceAssembly, getComponentNamesWithStatus, getComponentState, getConfigurationDescriptors, getFrameworkComponentInfoList, getFrameworkComponentInfoListForEnginesAndBindings, getFrameworkComponentInfoListForSharedLibraries, getFrameworkComponentInfoListForSharedLibraryNames, getFrameworkComponentQuery, getServiceAssemblyInfoList, getSystemLoggerMBeans, getUiComponentInfoList, isExistingComponent, isExistingSharedLibrary, listComponents, targetUpCheck, toFrameworkComponentInfoState, toFrameworkComponentInfoType, toFrameworkServiceAssemblyState, toUiComponentInfo, toUiComponentInfoList, toUiComponentInfoState, toUiComponentInfoType, toUiServiceAssemblyState, toUiServiceUnitState, updateEachServiceUnitInfoStateInServiceAssemblyInfo, updateServiceAssemblyInfoState, updateServiceUnitInfoState, validateUiJBIComponentInfoState, validateUiServiceAssemblyInfoState

Methods inherited from class com.sun.esb.management.base.services.AbstractServiceMBeansImpl

checkForValidTarget, checkForValidTarget, checkTargetType, constructMBeanAttributes, constructMBeanAttributes, constructMBeanAttributes, createManagementException, createManagementMessage, domainTargetCheck, findLiveExtensionMBeanObjectNames, getAdminServiceMBeanObjectName, getAdminServiceMBeanObjectName, getAttributeValue, getAttributeValue, getAttributeValue, getAttributeValue, getDeploymentServiceMBeanObjectName, getEbiJmxDomain, getEbiStatusMBeanObjectName, getEnvironmentContext, getI18NBundle, getI18NBundle, getInstallationServiceMBeanObjectName, getMBeanAttribute, getMBeanAttributeValues, getMBeanAttributeValuesAsMap, getMBeanServerConnection, getPlatformContext, getPlatformContextAdminServerName, getPlatformContextClusteredServerNames, getPlatformContextClusterNames, getPlatformContextInstallRoot, getPlatformContextInstanceName, getPlatformContextInstanceRoot, getPlatformContextJmxRmiPort, getPlatformContextMBeanServer, getPlatformContextServersInCluster, getPlatformContextStandaloneServerNames, getPlatformContextTargetName, getPlatformContextTargetName, getStackTrace, invokeMBeanOperation, invokeMBeanOperation, invokeMBeanOperation, invokeMBeanOperation, invokeMBeanOperation, isMBeanRegistered, isPlatformContextAdminServer, isPlatformContextCluster, isPlatformContextClusteredServer, isPlatformContextInstanceClustered, isPlatformContextInstanceUp, isPlatformContextStandaloneServer, isPlatformContextValidTarget, isTargetUp, isValidTarget, isValidTarget, listTargetNames, log, logDebug, logDebug, logError, logWarning, platformContextSupportsMultipleServers, setAttributeValue, setAttributeValue, setAttributeValue, setMBeanAttribute, setMBeanAttributes, setMBeanAttributes, setMBeanConfigAttributes, setMBeanConfigAttributes

Methods inherited from class java.lang.Object

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

Constructor Detail

ConfigurationServiceMBeanImpl

public ConfigurationServiceMBeanImpl(EnvironmentContext anEnvContext)

Constructor - Constructs a new instance of ConfigurationServiceMBeanImpl

Parameters:

anEnvContext -

Method Detail

isComponentConfigSupported

public boolean isComponentConfigSupported(String componentName,
                                 String targetName)
                                   throws ManagementRemoteException

Detect the components support for component configuration. This method returns true if the component has a configuration MBean with configurable attributes

Specified by:

isComponentConfigSupported in interface ConfigurationService

Parameters:

componentName - component identification

targetName - identification of the target. Can be a standalone server, cluster or clustered instance.

Returns:

true if the components configuration MBean has configuration attributes

Throws:

ManagementRemoteException - if the component is not installed or is not in the Started state.

isAppConfigSupported

public boolean isAppConfigSupported(String componentName,
                           String targetName)
                             throws ManagementRemoteException

Detect the components support for application configuration. This method returns true if the component has a configuration MBean and implements all the operations for application configuration management.

Specified by:

isAppConfigSupported in interface ConfigurationService

Parameters:

componentName - component identification

targetName - identification of the target. Can be a standalone server, cluster or clustered instance.

Returns:

true if the components configuration MBean implements all the operations for application configuration.

Throws:

ManagementRemoteException - if the component is not installed or is not in the Started state.

isAppVarsSupported

public boolean isAppVarsSupported(String componentName,
                         String targetName)
                           throws ManagementRemoteException

Detect the components support for application variables. This method returns true if the component has a configuration MBean and implements all the operations for application variable management.

Specified by:

isAppVarsSupported in interface ConfigurationService

Parameters:

componentName - component identification

targetName - identification of the target. Can be a standalone server, cluster or clustered instance.

Returns:

true if the components configuration MBean implements all the operations for application variables.

Throws:

ManagementRemoteException - if the component is not installed or is not in the Started state.

queryApplicationConfigurationType

public CompositeType queryApplicationConfigurationType(String componentName,
                                              String targetName)
                                                throws ManagementRemoteException

Get the CompositeType definition for the components application configuration

Specified by:

queryApplicationConfigurationType in interface ConfigurationService

Parameters:

componentName - component identification

targetName - identification of the target. Can be a standalone server, cluster or clustered instance.

Returns:

the CompositeType for the components application configuration.

Throws:

ManagementRemoteException

addApplicationConfiguration

public String addApplicationConfiguration(String componentName,
                                 String targetName,
                                 String name,
                                 Properties config)
                                   throws ManagementRemoteException

Add a named application configuration to a component installed on a given target.

Specified by:

addApplicationConfiguration in interface ConfigurationService

Parameters:

componentName - component identification

targetName - identification of the target. Can be a standalone server, cluster or clustered instance.

name - application configuration name

config - application configuration represented as a set of properties.

Returns:

a JBI Management message indicating the status of the operation.

Throws:

ManagementRemoteException - if there is a jmx error accessing the instance

See Also:

ConfigurationService.addApplicationConfiguration(java.lang.String, java.lang.String, java.lang.String, java.util.Properties)

addApplicationVariables

public String addApplicationVariables(String componentName,
                             String targetName,
                             Properties appVariables)
                               throws ManagementRemoteException

Add application variables to a component installed on a given target. If even a variable from the set is already set on the component, this operation fails.

Specified by:

addApplicationVariables in interface ConfigurationService

Parameters:

componentName - component identification

targetName - identification of the target. Can be a standalone server, cluster or clustered instance.

appVariables - - set of application variables to add. The values of the application variables have the application variable type and value and the format is "[type]value"

Returns:

a JBI Management message indicating the status of the operation. In case a variable is not added the management message has a ERROR task status message giving the details of the failure.

Throws:

ManagementRemoteException - if there is a jmx error accessing the instance

See Also:

ConfigurationService.addApplicationVariables(java.lang.String, java.lang.String, java.util.Properties)

deleteApplicationConfiguration

public String deleteApplicationConfiguration(String componentName,
                                    String targetName,
                                    String name)
                                      throws ManagementRemoteException

Delete a named application configuration in a component installed on a given target.

Specified by:

deleteApplicationConfiguration in interface ConfigurationService

Parameters:

componentName - component identification

targetName - identification of the target. Can be a standalone server, cluster or clustered instance.

name - name of application configuration to be deleted

Returns:

a JBI Management message indicating the status of the operation.

Throws:

ManagementRemoteException - if there is a jmx error accessing the instance

See Also:

ConfigurationService.deleteApplicationConfiguration(java.lang.String, java.lang.String, java.lang.String)

deleteApplicationVariables

public String deleteApplicationVariables(String componentName,
                                String targetName,
                                String[] appVariableNames)
                                  throws ManagementRemoteException

Delete application variables from a component installed on a given target. If even a variable from the set has not been added to the component, this operation fails.

Specified by:

deleteApplicationVariables in interface ConfigurationService

Parameters:

componentName - component identification

targetName - identification of the target. Can be a standalone server, cluster or clustered instance.

appVariableNames - - names of application variables to delete.

Returns:

a JBI Management message indicating the status of the operation. In case a variable is not deleted the management message has a ERROR task status message giving the details of the failure.

Throws:

ManagementRemoteException - if there is a jmx error accessing the instance *

See Also:

ConfigurationService.deleteApplicationVariables(java.lang.String, java.lang.String, java.lang.String[])

exportApplicationConfiguration

public String exportApplicationConfiguration(String applicationName,
                                    String targetName,
                                    String configDir)
                                      throws ManagementRemoteException

This method is used to export the application variables and application configuration objects used by the given application in the specified target.

Specified by:

exportApplicationConfiguration in interface ConfigurationService

Parameters:

applicationName - the name of the application

targetName - the target whose configuration has to be exported

configDir - the dir to store the configurations

Throws:

ManagementRemoteException - if the application configuration could not be exported Note: param configDir is used between ant/cli and common client client. The return value is used between common client server and common client client.

See Also:

ConfigurationService.exportApplicationConfiguration(java.lang.String, java.lang.String, java.lang.String)

getApplicationConfiguration

public Properties getApplicationConfiguration(String componentName,
                                     String name,
                                     String targetName)
                                       throws ManagementRemoteException

Get a specific named configuration. If the named configuration does not exist in the component the returned properties is an empty set.

Specified by:

getApplicationConfiguration in interface ConfigurationService

Parameters:

componentName - component identification

targetName - identification of the target. Can be a standalone server, cluster or clustered instance.

Returns:

the application configuration represented as a set of properties.

Throws:

ManagementRemoteException - if there is a jmx error accessing the instance

See Also:

ConfigurationService.getApplicationConfiguration(java.lang.String, java.lang.String, java.lang.String)

getApplicationConfigurations

public Map<String,Properties> getApplicationConfigurations(String componentName,
                                                  String targetName)
                                                    throws ManagementRemoteException

Get all the application configurations set on a component.

Specified by:

getApplicationConfigurations in interface ConfigurationService

Parameters:

componentName - component identification

targetName - identification of the target. Can be a standalone server, cluster or clustered instance.

Returns:

a map of all the application configurations keyed by the configuration name.

Throws:

ManagementRemoteException - if there is a jmx error accessing the instance

See Also:

ConfigurationService.getApplicationConfigurations(java.lang.String, java.lang.String)

getApplicationVariables

public Properties getApplicationVariables(String componentName,
                                 String targetName)
                                   throws ManagementRemoteException

Get all the application variables set on a component.

Specified by:

getApplicationVariables in interface ConfigurationService

Returns:

all the application variables et on the component. The return proerties set has the name="[type]value" pairs for the application variables.

Throws:

ManagementRemoteException - if there is a jmx error accessing the instance

See Also:

ConfigurationService.getApplicationVariables(java.lang.String, java.lang.String)

getComponentConfiguration

public Properties getComponentConfiguration(String componentName,
                                   String targetName)
                                     throws ManagementRemoteException

Retrieve component configuration

Specified by:

getComponentConfiguration in interface ConfigurationService

Parameters:

componentName -

targetName -

Returns:

the targetName as key and the name/value pairs as properties

Throws:

ManagementRemoteException - if there is a jmx error accessing the instance

See Also:

ConfigurationService.getComponentConfiguration(java.lang.String, java.lang.String)

getComponentExtensionMBeanObjectNames

public Map<String,ObjectName[]> getComponentExtensionMBeanObjectNames(String componentName,
                                                             String extensionName,
                                                             String targetName)
                                                               throws ManagementRemoteException

Gets the extension MBean object names

Specified by:

getComponentExtensionMBeanObjectNames in interface ConfigurationService

Overrides:

getComponentExtensionMBeanObjectNames in class AbstractServiceMBeansImpl

Parameters:

componentName - name of the component

extensionName - the name of the extension (e.g., Configuration, Logger, etc.)

targetName - name of the target (e.g., cluster1, server, etc.)

Returns:

Throws:

ManagementRemoteException - on error

See Also:

ConfigurationService.getComponentExtensionMBeanObjectNames(java.lang.String, java.lang.String, java.lang.String)

getComponentExtensionMBeanObjectNames

public ObjectName[] getComponentExtensionMBeanObjectNames(String componentName,
                                                 String extensionName,
                                                 String targetName,
                                                 String targetInstanceName)
                                                   throws ManagementRemoteException

Gets the extension MBean object names

Specified by:

getComponentExtensionMBeanObjectNames in interface ConfigurationService

Overrides:

getComponentExtensionMBeanObjectNames in class AbstractServiceMBeansImpl

Parameters:

componentName - name of the component

extensionName - the name of the extension (e.g., Configuration, Logger, etc.)

targetName - name of the target (e.g., cluster1, server, etc.)

targetInstanceName - name of the target instance (e.g., cluster1-instance1, etc.)

Returns:

an array of ObjectName(s)

Throws:

ManagementRemoteException - on error

See Also:

ConfigurationService.getComponentExtensionMBeanObjectNames(java.lang.String, java.lang.String, java.lang.String, java.lang.String)

getComponentLoggerLevels

public Map<String,Level> getComponentLoggerLevels(String componentName,
                                         String targetName,
                                         String targetInstanceName)
                                           throws ManagementRemoteException

Gets the component custom loggers and their levels

Specified by:

getComponentLoggerLevels in interface ConfigurationService

Parameters:

componentName - name of the component

targetName - name of the target (e.g., cluster1, server, etc.)

targetInstanceName - name of the target instance (e.g., cluster1-instance1, etc.)

Returns:

a Map of loggerName to their log levels

Throws:

ManagementRemoteException - on error

See Also:

ConfigurationService.getComponentLoggerLevels(java.lang.String, java.lang.String, java.lang.String)

getComponentLoggerDisplayNames

public Map<String,String> getComponentLoggerDisplayNames(String componentName,
                                                String targetName,
                                                String targetInstanceName)
                                                  throws ManagementRemoteException

Gets the component custom loggers and their display names.

Specified by:

getComponentLoggerDisplayNames in interface ConfigurationService

Parameters:

componentName - name of the component

targetName - name of the target (e.g., cluster1, server, etc.)

targetInstanceName - name of the target instance (e.g., cluster1-instance1, etc.)

Returns:

a Map of loggerName to their display names

Throws:

ManagementRemoteException - on error

See Also:

ConfigurationService.getComponentLoggerDisplayNames(java.lang.String, java.lang.String, java.lang.String)

getDefaultRuntimeConfiguration

public Properties getDefaultRuntimeConfiguration()
                                          throws ManagementRemoteException

This method returns a tabular data of a complex open data objects that represent the runtime configuration parameter descriptor. The parameter descriptor should contain the following data that represents the parameter. name : name of the parameter value : value of the parameter as a String type. type : type of the parameter. Basic data types only. description: (optional) description of the parameter. displayName: (optional) display name of the parameter readOnly : true/false validValues : (optional) list of string values with ',' as delimiter. or a range value with - with a '-' as delimiter. min and max strings will be converted to the parameter type and then used to validate the value of the parameter.

Specified by:

getDefaultRuntimeConfiguration in interface ConfigurationService

Parameters:

targetName - cluster or instance name ( e.g. cluster1, instance1 ) on which configuration parameters will be set. null to represent the default instance which is admin server

Returns:

Properties that represents the list of configuration parameter descriptors.

Throws:

ManagementRemoteException - if there is a jmx error accessing the instance

See Also:

ConfigurationService.getDefaultRuntimeConfiguration()

getRuntimeConfiguration

public Properties getRuntimeConfiguration(String targetName)
                                   throws ManagementRemoteException

This method returns a tabular data of a complex open data objects that represent the runtime configuration parameter descriptor. The parameter descriptor should contain the following data that represents the parameter. name : name of the parameter value : value of the parameter as a String type. type : type of the parameter. Basic data types only. description: (optional) description of the parameter. displayName: (optional) display name of the parameter readOnly : true/false validValues : (optional) list of string values with ',' as delimiter. or a range value with - with a '-' as delimiter. min and max strings will be converted to the parameter type and then used to validate the value of the parameter.

Specified by:

getRuntimeConfiguration in interface ConfigurationService

Parameters:

targetName - cluster or instance name ( e.g. cluster1, instance1 ) on which configuration parameters will be set. null to represent the default instance which is admin server

Returns:

Properties that represents the list of configuration parameter descriptors.

Throws:

ManagementRemoteException - if there is a jmx error accessing the instance

See Also:

ConfigurationService.getRuntimeConfiguration(java.lang.String)

getRuntimeConfigurationMetaData

public Properties getRuntimeConfigurationMetaData(String propertyKeyName)
                                           throws ManagementRemoteException

This method returns the runtime configuration metadata associated with the specified property. The metadata contain name-value pairs like: default, descriptionID, descriptorType, displayName, displayNameId, isStatic, name, resourceBundleName, tooltip, tooltipId, etc.

Specified by:

getRuntimeConfigurationMetaData in interface ConfigurationService

Parameters:

propertyKeyName -

Returns:

Properties that represent runtime configuration metadata

Throws:

ManagementRemoteException

See Also:

ConfigurationService.getRuntimeConfigurationMetaData(java.lang.String)

getRuntimeLoggerLevel

public Level getRuntimeLoggerLevel(String runtimeLoggerName,
                          String targetName,
                          String targetInstanceName)
                            throws ManagementRemoteException

Lookup the level of one runtime logger

Specified by:

getRuntimeLoggerLevel in interface ConfigurationService

Parameters:

runtimeLoggerName - name of the runtime logger (e.g. com.sun.jbi.framework

targetName - name of the target (e.g., cluster1, server, etc.)

targetInstanceName - name of the target instance (e.g., cluster1-instance1, etc.)

Returns:

the matching Log Level.

Throws:

ManagementRemoteException

See Also:

ConfigurationService.getRuntimeLoggerLevel(java.lang.String, java.lang.String, java.lang.String)

getRuntimeLoggerLevels

public Map<String,Level> getRuntimeLoggerLevels(String targetName,
                                       String targetInstanceName)
                                         throws ManagementRemoteException

Gets all the runtime loggers and their levels

Specified by:

getRuntimeLoggerLevels in interface ConfigurationService

Parameters:

targetName - name of the target (e.g., cluster1, server, etc.)

targetInstanceName - name of the target instance (e.g., cluster1-instance1, etc.)

Returns:

a Map of runtimeLoggerName to their log levels

Throws:

ManagementRemoteException - on error

See Also:

ConfigurationService.getRuntimeLoggerLevels(java.lang.String, java.lang.String)

getRuntimeLoggerNames

public Map<String,String> getRuntimeLoggerNames(String targetName,
                                       String targetInstanceName)
                                         throws ManagementRemoteException

Gets all the runtime loggers and their display names

Specified by:

getRuntimeLoggerNames in interface ConfigurationService

Parameters:

targetName - name of the target (e.g., cluster1, server, etc.)

targetInstanceName - name of the target instance (e.g., cluster1-instance1, etc.)

Returns:

a Map of display names to their logger MBeans

Throws:

ManagementRemoteException - on error

getRuntimeLoggerLevels

public Map<String,Level> getRuntimeLoggerLevels(String targetName)
                                         throws ManagementRemoteException

Gets all the runtime loggers and their levels.

Specified by:

getRuntimeLoggerLevels in interface ConfigurationService

Parameters:

targetName - name of the target (e.g., cluster1, server, etc.)

Returns:

a Map of runtimeLoggerName to their log levels

Throws:

ManagementRemoteException - on error

getRuntimeLoggerLevel

public Level getRuntimeLoggerLevel(String runtimeLoggerName,
                          String targetName)
                            throws ManagementRemoteException

Lookup the level of one runtime logger

Specified by:

getRuntimeLoggerLevel in interface ConfigurationService

Parameters:

runtimeLoggerName - name of the runtime logger (e.g. com.sun.jbi.framework

targetName - name of the target (e.g., cluster1, server, etc.)

targetInstanceName - name of the target instance (e.g., cluster1-instance1, etc.)

Returns:

the matching Log Level.

Throws:

ManagementRemoteException - on error

getRuntimeLoggerNames

public Map<String,String> getRuntimeLoggerNames(String targetName)
                                         throws ManagementRemoteException

Gets all the runtime loggers and their display names

Specified by:

getRuntimeLoggerNames in interface ConfigurationService

Parameters:

targetName - name of the target (e.g., cluster1, server, etc.)

targetInstanceName - name of the target instance (e.g., cluster1-instance1, etc.)

Returns:

a Map of display names to their logger MBeans

Throws:

ManagementRemoteException - on error

getRuntimeLoggerDisplayName

public String getRuntimeLoggerDisplayName(String runtimeLoggerName,
                                 String targetName)
                                   throws ManagementRemoteException

Return the display name for a runtime logger

Specified by:

getRuntimeLoggerDisplayName in interface ConfigurationService

Parameters:

runtimeLoggerName - name of the logger (e.g. com.sun.jbi.framework)

targetName - name of the target (e.g., cluster1, server, etc.)

Returns:

the display name for the given logger

Throws:

ManagementRemoteException - on error

isServerRestartRequired

public boolean isServerRestartRequired()
                                throws ManagementRemoteException

checks if the server need to be restarted to apply the changes made to some of the configuration parameters.

Specified by:

isServerRestartRequired in interface ConfigurationService

Returns:

true if server need to be restarted for updated configuration to take effect. false if no server restart is needed.

Throws:

ManagementRemoteException

See Also:

ConfigurationService.isServerRestartRequired()

listApplicationConfigurationNames

public String[] listApplicationConfigurationNames(String componentName,
                                         String targetName)
                                           throws ManagementRemoteException

List all the application configurations in a component.

Specified by:

listApplicationConfigurationNames in interface ConfigurationService

Parameters:

componentName - component identification

targetName - identification of the target. Can be a standalone server, cluster or clustered instance.

Returns:

an array of names of all the application configurations.

Throws:

ManagementRemoteException - if there is a jmx error accessing the instance

See Also:

ConfigurationService.listApplicationConfigurationNames(java.lang.String, java.lang.String)

setApplicationConfiguration

public String setApplicationConfiguration(String componentName,
                                 String name,
                                 Properties config,
                                 String targetName)
                                   throws ManagementRemoteException

Update a named application configuration in a component installed on a given target.

Specified by:

setApplicationConfiguration in interface ConfigurationService

Parameters:

componentName - component identification

targetName - identification of the target. Can be a standalone server, cluster or clustered instance.

name - application configuration name

config - application configuration represented as a set of properties.

Returns:

a JBI Management message indicating the status of the operation.

Throws:

ManagementRemoteException - if there is a jmx error accessing the instance

See Also:

ConfigurationService.setApplicationConfiguration(java.lang.String, java.lang.String, java.util.Properties, java.lang.String)

setApplicationVariables

public String setApplicationVariables(String componentName,
                             Properties appVariables,
                             String targetName)
                               throws ManagementRemoteException

Set application variables on a component installed on a given target. If even a variable from the set has not been added to the component, this operation fails.

Specified by:

setApplicationVariables in interface ConfigurationService

Parameters:

componentName - component identification

targetName - identification of the target. Can be a standalone server, cluster or clustered instance.

appVariables - - set of application variables to update. The values of the application variables have the application variable type and value and the format is "[type]value"

Returns:

a JBI Management message indicating the status of the operation. In case a variable is not set the management message has a ERROR task status message giving the details of the failure.

Throws:

ManagementRemoteException - if there is a jmx error accessing the instance

See Also:

com.sun.esb.management.api.configuration.ConfigurationService#setApplicationVariables(java.lang.String, java.lang.String, java.util.Properties)

setComponentConfiguration

public String setComponentConfiguration(String componentName,
                               Properties configurationValues,
                               String targetName)
                                 throws ManagementRemoteException

Set the component static configuration. This operation uses the facade component configuration MBean to set the component properties.

Specified by:

setComponentConfiguration in interface ConfigurationService

Parameters:

componentName -

targetName -

configurationValues -

Returns:

a management message indicating the status of the operation. If the operation fails a JBIException ( encapsulated in the ManagementRemoteException ) is thrown, the exception message is a management XML message and gives the failure details.

Throws:

ManagementRemoteException

See Also:

ConfigurationService.setComponentConfiguration(java.lang.String, java.util.Properties, java.lang.String)

setComponentLoggerLevel

public void setComponentLoggerLevel(String componentName,
                           String loggerCustomName,
                           Level logLevel,
                           String targetName,
                           String targetInstanceName)
                             throws ManagementRemoteException

Sets the component log level for a given logger

Specified by:

setComponentLoggerLevel in interface ConfigurationService

Parameters:

componentName - name of the component

loggerName - the component logger name

logLevel - the level to set the logger; when null, reverts the logger to inherit its level from its parent logger

targetName - name of the target (e.g., cluster1, server, etc.)

targetInstanceName - name of the target instance (e.g., cluster1-instance1, etc.)

Throws:

ManagementRemoteException - on error

See Also:

ConfigurationService.setComponentLoggerLevel(java.lang.String, java.lang.String, java.util.logging.Level, java.lang.String, java.lang.String)

setRuntimeConfiguration

public boolean setRuntimeConfiguration(Properties parameters,
                              String targetName)
                                throws ManagementRemoteException

This method sets one or more configuration parameters on the runtime with a list of name/value pairs passed as a properties object. The property name in the properties object should be an existing configuration parameter name. If user try to set the parameter that is not in the configuration parameters list, this method will throw an exception. The value of the property can be any object. If the value is non string object, its string value (Object.toString()) will be used as a value that will be set on the configuration. This method first validates whether all the paramters passed in properties object exist in the runtime configuration or not. If any one the parameters passed is not existing, it will return an error without settings the parameters that are passed in the properties including a valid parameters. If there is an error in setting a paramter, this method throws an exception with the list of parameters that were not set.

Specified by:

setRuntimeConfiguration in interface ConfigurationService

Parameters:

Properties - params Properties object that contains name/value pairs corresponding to the configuration parameters to be set on the runtime.

targetName - cluster or instance name ( e.g. cluster1, instance1 ) on which configuration parameters will be set. null to represent the default instance which is admin server

Returns:

true if server restart is required, false if not

Throws:

ManagementRemoteException - if there is a jmx error or a invalid parameter is passed in the params properties object. In case of an error setting the a particular parameter, the error message should list the invalid parameters.

See Also:

ConfigurationService.setRuntimeConfiguration(java.util.Properties, java.lang.String)

setRuntimeLoggerLevel

public void setRuntimeLoggerLevel(String runtimeLoggerName,
                         Level logLevel,
                         String targetName,
                         String targetInstanceName)
                           throws ManagementRemoteException

Sets the log level for a given runtime logger

Specified by:

setRuntimeLoggerLevel in interface ConfigurationService

Parameters:

runtimeLoggerName - name of the runtime logger

logLevel - the level to set the logger

targetName - name of the target (e.g., cluster1, server, etc.)

targetInstanceName - name of the target instance (e.g., cluster1-instance1, etc.)

Throws:

ManagementRemoteException - on error

See Also:

ConfigurationService.setRuntimeLoggerLevel(java.lang.String, java.util.logging.Level, java.lang.String, java.lang.String)

setRuntimeLoggerLevel

public void setRuntimeLoggerLevel(String runtimeLoggerName,
                         Level logLevel,
                         String targetName)
                           throws ManagementRemoteException

Sets the log level for a given runtime logger

Specified by:

setRuntimeLoggerLevel in interface ConfigurationService

Parameters:

runtimeLoggerName - name of the runtime logger

logLevel - the level to set the logger

targetName - name of the target (e.g., cluster1, server, etc.)

Throws:

ManagementRemoteException - on error

getRuntimeLoggerDisplayName

public String getRuntimeLoggerDisplayName(String runtimeLoggerName,
                                 String targetName,
                                 String targetInstanceName)
                                   throws ManagementRemoteException

Return the display name for a runtime logger

Specified by:

getRuntimeLoggerDisplayName in interface ConfigurationService

Parameters:

runtimeLoggerName - name of the logger (e.g. com.sun.jbi.framework)

targetName - name of the target (e.g., cluster1, server, etc.)

targetInstanceName - name of the target instance (e.g., cluster1-instance1, etc.)

Returns:

the display name for the given logger

Throws:

ManagementRemoteException - on error

verifyApplication

public String verifyApplication(String applicationURL,
                       boolean generateTemplates,
                       String templateDir,
                       boolean includeDeployCommand,
                       String targetName,
                       String clientSAFilePath)
                         throws ManagementRemoteException

This method is used to verify if the application variables and application configuration objects used in the given application are available in JBI runtime in the specified target. Also this method verifies if all necessary components are installed. If generateTemplates is true templates for missing application variables and application configurations are generated. A command script that uses the template files to set configuration objects is generated.

Specified by:

verifyApplication in interface ConfigurationService

Parameters:

applicationURL - the URL for the application zip file

generateTemplates - true if templates have to be generated

templateDir - the dir to store the generated templates

includeDeployCommand - true if the generated script should include deploy command

targetName - the target on which the application has to be verified

clientSAFilePath - the path to the SA in the client file schemaorg_apache_xmlbeans.system

Throws:

ManagementRemoteException - if the application could not be verified Note: param templateDir is used between ant/cli and common client client TemplateZIPID is used between common client server and common client client

See Also:

com.sun.esb.management.api.configuration.ConfigurationService#verifyApplication(java.lang.String, java.lang.String, boolean, java.lang.String, boolean)

getComponentConfigurationFacadeMBeanName

protected ObjectName getComponentConfigurationFacadeMBeanName(String componentName,
                                                  String targetName)
                                                       throws ManagementRemoteException

Get the component configuration facade MBean name for the target. If the component is not installed on the target, this returns a null.

Parameters:

componentName - - component id

targetName - - target name

Returns:

the ObjectName of the components facade Configuration MBean for a target.

Throws:

ManagementRemoteException

getComponentConfigurationForClusteredServer

protected Properties getComponentConfigurationForClusteredServer(String componentName,
                                                     String targetName)
                                                          throws ManagementRemoteException

Retrieve component configuration for a clustered server (that is up)

Parameters:

componentName -

targetName -

Returns:

the targetName as key and the name/value pairs as properties

Throws:

ManagementRemoteException

getConfigMBeanName

protected ObjectName getConfigMBeanName(String componentName,
                            String targetName)
                                 throws ManagementRemoteException

Find the actual object config MBean Name -- used by both g/setting component configuations for clustered servers

Parameters:

componentName -

targetName -

Returns:

the actual component's config MBean name

Throws:

ManagementRemoteException

convertToString

protected String convertToString(Collection colxn)

Convert the objects in the collection to a printable string.

Parameters:

set - a non-empty set

getExtensionMBeanObjectName

protected ObjectName getExtensionMBeanObjectName(String componentName,
                                     String targetName)
                                          throws ManagementRemoteException

returns the ObjectName for the Extension Mbean of this component.

Overrides:

getExtensionMBeanObjectName in class AbstractServiceMBeansImpl

Parameters:

componentName -

targetName -

Returns:

the ObjectName of the Extension MBean or null.

Throws:

ManagementRemoteException

getConfigurationAttributeValues

protected Properties getConfigurationAttributeValues(ObjectName objectName)
                                              throws ManagementRemoteException

Get the config extension MBean attribute values

Parameters:

objectName -

Returns:

Throws:

ManagementRemoteException

getConfigurationAttributeValuesAsMap

protected Map<String,Object> getConfigurationAttributeValuesAsMap(ObjectName objectName)
                                                           throws ManagementRemoteException

Get the config extension MBean attribute values

Parameters:

objectName -

Returns:

Throws:

ManagementRemoteException

getDefaultRuntimeConfigurationInternal

protected Properties getDefaultRuntimeConfigurationInternal(String targetName)
                                                     throws ManagementRemoteException

Get the default JBI runtime configuration

Parameters:

targetName -

Returns:

Throws:

ManagementRemoteException

getConfigurationMBeanObjectName

public ObjectName getConfigurationMBeanObjectName(String targetName,
                                         String configurationType)
                                           throws ManagementRemoteException

Get the JBI Runtime Configuration Service MBean Object Name

Parameters:

targetName -

configurationType -

Returns:

Throws:

ManagementRemoteException

getLoggingServiceMBeanObjectName

public ObjectName getLoggingServiceMBeanObjectName(String targetName)

returns the ObjectName for the LoggingService Mbean of this target.

Parameters:

targetName -

Returns:

the ObjectName of the LoggingService MBean or null.

setLevel

protected String setLevel(Level logLevel)

Return the "verb" (the setXXX MBean operation) for the given log level

Overrides:

setLevel in class AbstractServiceMBeansImpl

Parameters:

logLevel - log level to set logger to

Returns:

a MBean operation to set the logger to that level

setRuntimeConfigurationInternal

protected boolean setRuntimeConfigurationInternal(Properties properties,
                                      String targetName)
                                           throws ManagementRemoteException

Set JBI Runtime Configuration

Parameters:

properties -

targetName -

Returns:

Throws:

ManagementRemoteException

getApplicationConfigurationsMap

protected Map<String,Properties> getApplicationConfigurationsMap(TabularData td)

Convert a application configuration TabularData to a Map keyed by the "configurationName". The value is the application configuration represented as properties.

Returns:

a Map of application configuration properties

retrieveConfigurationDisplaySchema

public String retrieveConfigurationDisplaySchema(String componentName,
                                        String targetName)
                                          throws ManagementRemoteException

Retrieves the component specific configuration schema.

Specified by:

retrieveConfigurationDisplaySchema in interface ConfigurationService

Parameters:

componentName - component identification

targetName - identification of the target. Can be a standalone server, cluster or clustered instance.

Returns:

a String containing the configuration schema.

Throws:

ManagementRemoteException - on errors.

retrieveConfigurationDisplayData

public String retrieveConfigurationDisplayData(String componentName,
                                      String targetName)
                                        throws ManagementRemoteException

Retrieves the component configuration metadata. The XML data conforms to the component configuration schema.

Specified by:

retrieveConfigurationDisplayData in interface ConfigurationService

Parameters:

componentName - component identification

targetName - identification of the target. Can be a standalone server, cluster or clustered instance.

Returns:

a String containing the configuration metadata.

Throws:

ManagementRemoteException - on errors

addApplicationConfiguration

public String addApplicationConfiguration(String componentName,
                                 String targetName,
                                 String name,
                                 CompositeData appConfig)
                                   throws ManagementRemoteException

Add an application configuration. The configuration name is a part of the CompositeData. The itemName for the configuration name is "configurationName" and the type is SimpleType.STRING

Specified by:

addApplicationConfiguration in interface ConfigurationService

Parameters:

componentName -

targetName -

name - - configuration name, must match the value of the field "name" in the namedConfig

appConfig - - application configuration composite

Returns:

management message string which gives the status of the operation. For target=cluster, instance specific details are included.

Throws:

ManagementRemoteException - if the application configuration cannot be added.

setApplicationConfiguration

public String setApplicationConfiguration(String componentName,
                                 String targetName,
                                 String name,
                                 CompositeData appConfig)
                                   throws ManagementRemoteException

Update a application configuration. The configuration name is a part of the CompositeData. The itemName for the configuration name is "configurationName" and the type is SimpleType.STRING

Specified by:

setApplicationConfiguration in interface ConfigurationService

Parameters:

componentName -

targetName -

name - - configuration name, must match the value of the field "configurationName" in the appConfig

appConfig - - application configuration composite

Returns:

management message string which gives the status of the operation. For target=cluster, instance specific details are included.

Throws:

ManagementRemoteException - if there are errors encountered when updating the configuration.

getApplicationConfigurationsAsTabularData

public TabularData getApplicationConfigurationsAsTabularData(String componentName,
                                                    String targetName)
                                                      throws ManagementRemoteException

Get a Map of all application configurations for the component.

Specified by:

getApplicationConfigurationsAsTabularData in interface ConfigurationService

Parameters:

componentName -

targetName -

Returns:

a TabularData of all the application configurations for a component keyed by the configuration name.

Throws:

ManagementRemoteException - if there are errors encountered when updating the configuration.

getApplicationVariablesAsTabularData

public TabularData getApplicationVariablesAsTabularData(String componentName,
                                               String targetName)
                                                 throws ManagementRemoteException

Get the Application Variable set for a component.

Specified by:

getApplicationVariablesAsTabularData in interface ConfigurationService

Parameters:

componentName -

targetName -

Returns:

a TabularData which has all the application variables set on the component.

Throws:

ManagementRemoteException

addApplicationVariable

public String addApplicationVariable(String componentName,
                            String targetName,
                            String name,
                            CompositeData appVar)
                              throws ManagementRemoteException

This operation adds a new application variable. If a variable already exists with the same name as that specified then the operation fails.

Specified by:

addApplicationVariable in interface ConfigurationService

Parameters:

componentName -

targetName -

name - - name of the application variable

appVar - - this is the application variable composite

Returns:

management message string which gives the status of the operation. For target=cluster, instance specific details are included.

Throws:

ManagementRemoteException - if an error occurs in adding the application variables to the component.

setApplicationVariable

public String setApplicationVariable(String componentName,
                            String targetName,
                            String name,
                            CompositeData appVar)
                              throws ManagementRemoteException

This operation sets an application variable. If a variable does not exist with the same name, its an error.

Specified by:

setApplicationVariable in interface ConfigurationService

Parameters:

componentName -

targetName -

name - - name of the application variable

appVar - - this is the application variable composite to be updated.

Returns:

management message string which gives the status of the operation. For target=cluster, instance specific details are included.

Throws:

ManagementRemoteException - if one or more application variables cannot be deleted

getDefaultRuntimeConfigurationAsMap

public Map<String,Object> getDefaultRuntimeConfigurationAsMap()
                                                       throws ManagementRemoteException

This method returns a tabular data of a complex open data objects that represent the runtime configuration parameter descriptor. The parameter descriptor should contain the following data that represents the parameter. name : name of the parameter value : value of the parameter as a String type. type : type of the parameter. Basic data types only. description: (optional) description of the parameter. displayName: (optional) display name of the parameter readOnly : true/false validValues : (optional) list of string values with ',' as delimiter. or a range value with - with a '-' as delimiter. min and max strings will be converted to the parameter type and then used to validate the value of the parameter.

Specified by:

getDefaultRuntimeConfigurationAsMap in interface ConfigurationService

Returns:

Map that represents the list of configuration parameter descriptors.

Throws:

ManagementRemoteException - if there is a jmx error accessing the instance

getDefaultRuntimeConfigurationAsMapInternal

public Map<String,Object> getDefaultRuntimeConfigurationAsMapInternal(String targetName)
                                                               throws ManagementRemoteException

This method returns a tabular data of a complex open data objects that represent the runtime configuration parameter descriptor. The parameter descriptor should contain the following data that represents the parameter. name : name of the parameter value : value of the parameter as a String type. type : type of the parameter. Basic data types only. description: (optional) description of the parameter. displayName: (optional) display name of the parameter readOnly : true/false validValues : (optional) list of string values with ',' as delimiter. or a range value with - with a '-' as delimiter. min and max strings will be converted to the parameter type and then used to validate the value of the parameter.

Parameters:

targetName - cluster or instance name ( e.g. cluster1, instance1 ) on which configuration parameters will be set. null to represent the default instance which is admin server

Returns:

Map that represents the list of configuration parameter descriptors.

Throws:

ManagementRemoteException - if there is a jmx error accessing the instance

getRuntimeConfigurationAsMap

public Map<String,Object> getRuntimeConfigurationAsMap(String targetName)
                                                throws ManagementRemoteException

This method returns a tabular data of a complex open data objects that represent the runtime configuration parameter descriptor. The parameter descriptor should contain the following data that represents the parameter. name : name of the parameter value : value of the parameter as a String type. type : type of the parameter. Basic data types only. description: (optional) description of the parameter. displayName: (optional) display name of the parameter readOnly : true/false validValues : (optional) list of string values with ',' as delimiter. or a range value with - with a '-' as delimiter. min and max strings will be converted to the parameter type and then used to validate the value of the parameter.

Specified by:

getRuntimeConfigurationAsMap in interface ConfigurationService

Parameters:

targetName - cluster or instance name ( e.g. cluster1, instance1 ) on which configuration parameters will be set. null to represent the default instance which is admin server

Returns:

Map that represents the list of configuration parameter descriptors.

Throws:

ManagementRemoteException - if there is a jmx error accessing the instance

setRuntimeConfiguration

public boolean setRuntimeConfiguration(Map<String,Object> properties,
                              String targetName)
                                throws ManagementRemoteException

This method sets one or more configuration parameters on the runtime with a list of name/value pairs passed as a properties object. The property name in the properties object should be an existing configuration parameter name. If user try to set the parameter that is not in the configuration parameters list, this method will throw an exception. The value of the property can be any object. If the value is non string object, its string value (Object.toString()) will be used as a value that will be set on the configuration. This method first validates whether all the paramters passed in properties object exist in the runtime configuration or not. If any one the parameters passed is not existing, it will return an error without settings the parameters that are passed in the properties including a valid parameters. If there is an error in setting a paramter, this method throws an exception with the list of parameters that were not set.

Specified by:

setRuntimeConfiguration in interface ConfigurationService

Parameters:

params - Map object that contains name/value pairs corresponding to the configuration parameters to be set on the runtime.

targetName - cluster or instance name ( e.g. cluster1, instance1 ) on which configuration parameters will be set. null to represent the default instance which is admin server

Returns:

true if server restart is required, false if not

Throws:

ManagementRemoteException - if there is a jmx error or a invalid parameter is passed in the params properties object. In case of an error setting the a particular parameter, the error message should list the invalid parameters.

getComponentConfigurationAsMap

public Map<String,Object> getComponentConfigurationAsMap(String componentName,
                                                String targetName)
                                                  throws ManagementRemoteException

Retrieve component configuration

Specified by:

getComponentConfigurationAsMap in interface ConfigurationService

Parameters:

componentName -

targetName -

Returns:

the targetName as key and the name/value pairs as Map

Throws:

ManagementRemoteException - on error

setComponentConfiguration

public String setComponentConfiguration(String componentName,
                               Map<String,Object> configurationValues,
                               String targetName)
                                 throws ManagementRemoteException

Will return jbi mgmt message with success, failure, or partial success per instance. The entry per instance will have value as part of the management message (XML) String.

Specified by:

setComponentConfiguration in interface ConfigurationService

Parameters:

componentName -

configurationValues -

targetName -

Returns:

value as part of the management message (XML) String.

Throws:

ManagementRemoteException - on error

invokeExtensionMBeanOperation

public Object invokeExtensionMBeanOperation(String componentName,
                                   String extensionName,
                                   String operationName,
                                   Object[] parameters,
                                   String[] signature,
                                   String targetName,
                                   String targetInstanceName)
                                     throws ManagementRemoteException

Invokes an operation on an Extension MBean.

Specified by:

invokeExtensionMBeanOperation in interface ConfigurationService

Parameters:

componentName -

extensionName - the name of the extension (e.g., Configuration, Logger, etc.)

operationName - The name of the operation to be invoked.

parameters - An array containing the parameters to be set when the operation is invoked

signature - An array containing the signature of the operation. The class objects will be loaded using the same class loader as the one used for loading the MBean on which the operation was invoked.

targetName - name of the target (e.g., server, Cluster1, StandloneServer2, etc.)

targetInstanceName - name of the target instance (e.g., Cluster1-Instance1, Cluster2-Instance10, etc.)

Returns:

The object returned by the operation, which represents the result of invoking the operation on the Extension MBean specified.

Throws:

ManagementRemoteException

getRuntimeLoggerConfigFacadeMBeanName

protected ObjectName getRuntimeLoggerConfigFacadeMBeanName(String target)

Returns:

the runtime logger configuration facade MBean Name for the specific target.

getExistingAppVarType

protected String getExistingAppVarType(String compName,
                           String targetName,
                           String appVarName)

Returns:

the type of the actual application variable

validateTargetForRuntimeConfigurationSpport

protected void validateTargetForRuntimeConfigurationSpport(String targetName)
                                                    throws ManagementRemoteException

validates targetName and throws exception if the target is a clustered instance. For clustered instances, cluster name should be used for runtime configuration. The supported targets are target=server, target=standalone-instance target=cluster

Parameters:

targetName - name of the target intance.

Throws:

ManagementRemoteException