Package 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.

Rhino versions prior to 3.0.0 had two modes of operation for managing the activation state of services and resource adaptor entities: per-node and symmetric. From Rhino 3.0.0 these two modes were combined and have been superseded by default desired state which can be overridden by per-node desired state. Per-node desired state overrides default desired state if present. Default desired state is effective if no per-node desired state exists. The operations to enable and disable symmetric activation state mode remain but do not prevent later modification of per-node desired state.

Field Summary

Fields

Modifier and Type	Field	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

Modifier and Type	Method	Description
void	disableSymmetricActivationStateMode()	Deprecated. Superseded by declarative configuration support in Rhino 3.0.0
void	enableSymmetricActivationStateMode(int templateNodeID)	Deprecated. Superseded by declarative configuration support in Rhino 3.0.0
boolean	isSymmetricActivationStateModeEnabled()	Deprecated. Superseded by declarative configuration support in Rhino 3.0.0

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

@Deprecated(since="3.0.0")
void enableSymmetricActivationStateMode(int templateNodeID)
                                 throws InvalidStateException,
                                        InvalidArgumentException,
                                        ConfigurationException

Deprecated.

Superseded by declarative configuration support in Rhino 3.0.0

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.

The activation state of the SLEE itself (STOPPED or RUNNING) is not altered on any node.

If the pool clustering mode is being used, this method has no useful purpose and will always throw a ConfigurationException.

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 state 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, or if the node is configured to use the pool clustering mode.

See Also:

NodeHousekeepingMBean.getNodesWithPerNodeActivationState()

disableSymmetricActivationStateMode

@Deprecated(since="3.0.0")
void disableSymmetricActivationStateMode()
                                  throws InvalidStateException,
                                         ConfigurationException

Deprecated.

Superseded by declarative configuration support in Rhino 3.0.0

Disable the symmetric activation state mode.

Throws:

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

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

isSymmetricActivationStateModeEnabled

@Deprecated(since="3.0.0")
boolean isSymmetricActivationStateModeEnabled()
                                       throws ConfigurationException

Deprecated.

Superseded by declarative configuration support in Rhino 3.0.0

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.