com.atlassian.confluence.cluster
Interface ClusterConfigurationHelper

All Known Implementing Classes:
DefaultClusterConfigurationHelper, NonClusterConfigurationHelper

public interface ClusterConfigurationHelper

A facade for interacting with the clustering subsystem


Method Summary
 void bootstrapCluster()
          Checks whether clustering is enabled, and bootstraps the cluster manager with an appropriate configuration
 void createCluster(java.lang.String clusterName, java.io.File clusterHome)
          Creates a new cluster with the given name as long as the given cluster does not exist.
 void createCluster(java.lang.String clusterName, java.io.File clusterHome, java.lang.String networkInterfaceName)
          Creates a new cluster with the given name, on the specified network interface, as long as the given cluster does not exist.
 java.util.List getClusterableInterfaces()
          Return a list of interfaces suitable for clustered communication.
 int getPermittedClusterNodes()
           
 com.atlassian.fugue.Option<java.io.File> getSharedHome()
          Return the shared home directory if one has been configured.
 boolean isClusteredInstance()
           
 boolean isLicensedClusterNodesExceeded()
           
 void joinCluster(java.lang.String clusterName, java.io.File clusterHome)
          Join the named cluster, as long as it exists and the licensed member count is not exceeded.
 void joinCluster(java.lang.String clusterName, java.io.File clusterHome, java.lang.String networkInterfaceName)
          Join the named cluster, on the specified network interface, as long as it exists and the licensed member count is not exceeded.
 void publishConfiguration()
          Publish the configuration of this instance to the shared cluster cache, where it can be loaded by subsequent nodes during setup.
 

Method Detail

isClusteredInstance

boolean isClusteredInstance()
Returns:
true if the application is currently configured to be part of a cluster, otherwise false.

isLicensedClusterNodesExceeded

boolean isLicensedClusterNodesExceeded()
Returns:
true if the cluster which this node belongs to has more members than is allowed by the license, otherwise false.

joinCluster

void joinCluster(java.lang.String clusterName,
                 java.io.File clusterHome)
                 throws ClusterException
Join the named cluster, as long as it exists and the licensed member count is not exceeded.

Throws:
ClusterException - if an error joining the cluster.

joinCluster

void joinCluster(java.lang.String clusterName,
                 java.io.File clusterHome,
                 java.lang.String networkInterfaceName)
                 throws ClusterException
Join the named cluster, on the specified network interface, as long as it exists and the licensed member count is not exceeded.

Throws:
ClusterException - if an error joining the cluster.

createCluster

void createCluster(java.lang.String clusterName,
                   java.io.File clusterHome)
                   throws ClusterException
Creates a new cluster with the given name as long as the given cluster does not exist.

Throws:
ClusterException - if an error setting up the cluster.

createCluster

void createCluster(java.lang.String clusterName,
                   java.io.File clusterHome,
                   java.lang.String networkInterfaceName)
                   throws ClusterException
Creates a new cluster with the given name, on the specified network interface, as long as the given cluster does not exist.

Throws:
ClusterException - if an error setting up the cluster.

getPermittedClusterNodes

int getPermittedClusterNodes()
Returns:
the number of clustered nodes permitted by the license on this instance of Confluence.

bootstrapCluster

void bootstrapCluster()
                      throws ClusterException
Checks whether clustering is enabled, and bootstraps the cluster manager with an appropriate configuration

Throws:
ClusterException - if there was an error configuring the cluster manager, or if the licensed nodes were exceeded by joining the cluster.

publishConfiguration

void publishConfiguration()
Publish the configuration of this instance to the shared cluster cache, where it can be loaded by subsequent nodes during setup.


getClusterableInterfaces

java.util.List getClusterableInterfaces()
Return a list of interfaces suitable for clustered communication. The list is ordered for suitable rendering in a UI.

Returns:
List of NetworkInterface objects

getSharedHome

com.atlassian.fugue.Option<java.io.File> getSharedHome()
Return the shared home directory if one has been configured.

Returns:
shared home directory


Copyright © 2003-2014 Atlassian. All Rights Reserved.