Interface NodeManager

  • All Superinterfaces:
    ParameterInclude
    All Known Implementing Classes:
    DefaultNodeManager

    public interface NodeManager
    extends ParameterInclude

    This interface is responsible for handling configuration management. Configuraion changes include

    • Rebooting an entire cluster, in which case, all nodes have to load the new Axis2 configuration in a consistent manner
    • Deploying a new service to a cluster or undeploying a service from a cluster
    • Changing the policies of a service deployed on the cluster

    It is not mandatory to have a NodeManager in a node. In which case the cluster may be used only for High Availability through context replication. However, it is difficult to imagine that a cluster will be deployed in production with only context replication but without cluster configuration management.

    The implementation of this interface is set by the ClusterBuilder, by reading the "configurationManager" element in the axis2.xml

    e.g.

    • Method Detail

      • prepare

        void prepare()
              throws ClusteringFault
        First phase of the 2-phase commit protocol. Notifies a node that it needs to prepare to switch to a new configuration.
        Throws:
        ClusteringFault - If an error occurs while preparing to commit
      • rollback

        void rollback()
               throws ClusteringFault
        Rollback whatever was done
        Throws:
        ClusteringFault - If an error occurs while rolling back a cluster configuration transaction
      • commit

        void commit()
             throws ClusteringFault
        Second phase of the 2-phase commit protocol. Notifies a node that it needs to switch to a new configuration.
        Throws:
        ClusteringFault - If an error occurs while committing a cluster configuration transaction
      • exceptionOccurred

        void exceptionOccurred​(Throwable throwable)
                        throws ClusteringFault
        To notify other nodes that an Exception occurred, during the processing of a NodeManagementCommand
        Parameters:
        throwable - The throwable which has to be propogated to other nodes
        Throws:
        ClusteringFault - If an error occurs while processing the exception message
      • setConfigurationContext

        void setConfigurationContext​(ConfigurationContext configurationContext)
        Set the system's configuration context. This will be used by the clustering implementations to get information about the Axis2 environment and to correspond with the Axis2 environment
        Parameters:
        configurationContext - The configuration context