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.

    • 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()
      • 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.