com.opencloud.rhino.config.runtime

Interface RuntimeConfigManagementMBean

public interface RuntimeConfigManagementMBean

The RuntimeConfigManagementMBean interface provides access to Rhino configuration options that can be changed at runtime.

Field Summary

Fields

Modifier and Type	Field and Description
static String	MBEAN_NAME The name of this MBean, equal to the string "RuntimeConfig".
static String	OBJECT_NAME The JMX Object Name of this MBean.

Method Summary

Methods

Modifier and Type	Method and Description
void	disableSymmetricActivationStateMode() Disable the symmetric activation state mode.
void	enableSymmetricActivationStateMode(int templateNodeID) Enable the symmetric activation state mode.
boolean	isSymmetricActivationStateModeEnabled() Determine if the symmetric activation state mode is currently enabled.

Field Detail

MBEAN_NAME

static final String MBEAN_NAME

The name of this MBean, equal to the string "RuntimeConfig".

See Also:

Constant Field Values

OBJECT_NAME

static final String OBJECT_NAME

The JMX Object Name of this MBean.

See Also:

Constant Field Values

Method Detail

enableSymmetricActivationStateMode

void enableSymmetricActivationStateMode(int templateNodeID)
                                        throws InvalidStateException,
                                               InvalidArgumentException,
                                               ConfigurationException

Enable the symmetric activation state mode.

When the symmetric activation state mode is enabled, a template node ID must be specified. Services and resource adaptor entities on other cluster nodes will be activated and/or deactivated as needed so that they match the state of the template node. While the symmetric activation state mode continues to remain in force, services and resource adaptor entities are activated and deactivated across the cluster in unison, and per-node state operations for these components can no longer be used.

The activation state of the SLEE itself (STOPPED or RUNNING) is always configurable on a per-node basis.

Parameters:

templateNodeID - the node ID of the node to base the activation state of any other cluster nodes on. This node doesn't have to be a current cluster member, but it must have some per-node state already in existence.

Throws:

InvalidStateException - if the symmetric activation mode is already enabled, or if the mode cannot currently be set because a service or resource adaptor entity that needs to be in the ACTIVE state is currently STOPPING on some cluster node.

InvalidArgumentException - if an invalid node ID is specified or if the specified node has no per-node activation state.

ConfigurationException - if some other error occurs while trying to enable the mode.

See Also:

NodeHousekeepingMBean.getNodesWithPerNodeActivationState()

disableSymmetricActivationStateMode

void disableSymmetricActivationStateMode()
                                         throws InvalidStateException,
                                                ConfigurationException

Disable the symmetric activation state mode.

While the symmetric activation state mode is disabled, services and resource adaptor entities may have different activation states on different cluster nodes.

Throws:

InvalidStateException - if the symmetric activation state mode is already disabled.

ConfigurationException - if some other error occurs while trying to disable the mode.

isSymmetricActivationStateModeEnabled

boolean isSymmetricActivationStateModeEnabled()
                                              throws ConfigurationException

Determine if the symmetric activation state mode is currently enabled.

Returns:

true if the symmetric activation state mode is currently enabled, false otherwise.

Throws:

ConfigurationException - if an error occurs while trying to determine the current mode.