com.orientechnologies.orient.server.distributed

Interface ODistributedServerManager

public interface ODistributedServerManager

Server cluster interface to abstract cluster behavior.

Author:

Luca Garulli (l.garulli--at--orientdb.com)

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	ODistributedServerManager.DB_STATUS Database status.
static class	ODistributedServerManager.NODE_STATUS Server status.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	FILE_DISTRIBUTED_DB_CONFIG

Method Summary

Modifier and Type	Method and Description
boolean	checkNodeStatus(ODistributedServerManager.NODE_STATUS status)
java.lang.Throwable	convertException(java.lang.Throwable original)
<T> T	executeInDistributedDatabaseLock(java.lang.String databaseName, long timeoutLocking, OModifiableDistributedConfiguration lastCfg, com.orientechnologies.common.util.OCallable<T,OModifiableDistributedConfiguration> iCallback) Executes an operation protected by a distributed lock (one per database).
java.lang.Object	executeOnLocalNode(ODistributedRequestId reqId, ORemoteTask task, ODatabaseDocumentInternal database)
void	executeOnLocalNodeFromRemote(ODistributedRequest request)
java.util.Set<java.lang.String>	getActiveServers()
java.util.Set<java.lang.String>	getAvailableNodeNames(java.lang.String databaseName)
int	getAvailableNodes(java.util.Collection<java.lang.String> iNodes, java.lang.String databaseName)
int	getAvailableNodes(java.lang.String iDatabaseName)
com.orientechnologies.orient.core.record.impl.ODocument	getClusterConfiguration()
long	getClusterTime() Returns the cluster-wide time in milliseconds.
java.util.Map<java.lang.String,java.lang.Object>	getConfigurationMap()
java.lang.String	getCoordinatorServer() Deprecated.
ODistributedConfiguration	getDatabaseConfiguration(java.lang.String iDatabaseName)
ODistributedConfiguration	getDatabaseConfiguration(java.lang.String iDatabaseName, boolean createIfNotPresent)
ODistributedServerManager.DB_STATUS	getDatabaseStatus(java.lang.String iNode, java.lang.String iDatabaseName)
java.io.File	getDefaultDatabaseConfigFile()
ODistributedStrategy	getDistributedStrategy()
long	getLastClusterChangeOn()
com.orientechnologies.orient.core.record.impl.ODocument	getLocalNodeConfiguration()
int	getLocalNodeId()
java.lang.String	getLocalNodeName()
ODistributedLockManager	getLockManagerExecutor()
ODistributedLockManager	getLockManagerRequester()
ODistributedMessageService	getMessageService()
long	getNextMessageIdCounter()
com.orientechnologies.orient.core.record.impl.ODocument	getNodeConfigurationByUuid(java.lang.String iNode, boolean useCache)
int	getNodeIdByName(java.lang.String node)
java.lang.String	getNodeNameById(int id)
ODistributedServerManager.NODE_STATUS	getNodeStatus()
int	getNodesWithStatus(java.util.Collection<java.lang.String> iNodes, java.lang.String databaseName, ODistributedServerManager.DB_STATUS... statuses)
java.lang.String	getNodeUuidByName(java.lang.String name)
java.util.List<java.lang.String>	getOnlineNodes(java.lang.String iDatabaseName)
ORemoteServerController	getRemoteServer(java.lang.String nodeName)
OServer	getServerInstance()
com.orientechnologies.orient.core.record.impl.ODocument	getStats()
ORemoteTaskFactoryManager	getTaskFactoryManager() Returns the task factory manager.
int	getTotalNodes(java.lang.String iDatabaseName)
boolean	installDatabase(boolean iStartup, java.lang.String databaseName, boolean forceDeployment, boolean tryWithDeltaFirst)
boolean	isEnabled()
boolean	isNodeAvailable(java.lang.String iNodeName)
boolean	isNodeAvailable(java.lang.String iNodeName, java.lang.String databaseName) Available means not OFFLINE, so ONLINE or SYNCHRONIZING.
boolean	isNodeOnline(java.lang.String iNodeName, java.lang.String databaseName) Returns true if the node status is ONLINE.
boolean	isNodeStatusEqualsTo(java.lang.String iNodeName, java.lang.String iDatabaseName, ODistributedServerManager.DB_STATUS... statuses) Checks the node status if it's one of the statuses received as argument.
boolean	isOffline()
boolean	isWriteQuorumPresent(java.lang.String databaseName) Returns true if the quorum is present in terms of number of available nodes for full replication only.
default void	messageAfterOp(java.lang.String op, ODistributedRequestId requestId)
default void	messageBeforeOp(java.lang.String op, ODistributedRequestId requestId)
default void	messageCurrentPayload(ODistributedRequestId requestId, java.lang.Object responsePayload)
default void	messagePartitionCalculate(ODistributedRequest request, java.util.Set<java.lang.Integer> involvedWorkerQueues)
default void	messageProcessEnd(ODistributedRequest iRequest, java.lang.Object responsePayload)
default void	messageProcessStart(ODistributedRequest message)
default void	messageReceived(ODistributedRequest request)
void	notifyClients(java.lang.String databaseName)
void	reassignClustersOwnership(java.lang.String iNode, java.lang.String databaseName, OModifiableDistributedConfiguration cfg, boolean canCreateNewClusters)
ODistributedServerManager	registerLifecycleListener(ODistributedLifecycleListener iListener)
void	removeServer(java.lang.String nodeLeftName, boolean removeOnlyDynamicServers)
ODistributedResponse	sendRequest(java.lang.String iDatabaseName, java.util.Collection<java.lang.String> iClusterNames, java.util.Collection<java.lang.String> iTargetNodeNames, ORemoteTask iTask, long messageId, ODistributedRequest.EXECUTION_MODE iExecutionMode, java.lang.Object localResult) Sends a distributed request against multiple servers.
ODistributedResponse	sendRequest(java.lang.String iDatabaseName, java.util.Collection<java.lang.String> iClusterNames, java.util.Collection<java.lang.String> iTargetNodeNames, ORemoteTask iTask, long messageId, ODistributedRequest.EXECUTION_MODE iExecutionMode, java.lang.Object localResult, ODistributedResponseManagerFactory responseManagerFactory)
void	setDatabaseStatus(java.lang.String iNode, java.lang.String iDatabaseName, ODistributedServerManager.DB_STATUS iStatus)
void	setDistributedStrategy(ODistributedStrategy streatgy)
void	setNodeStatus(ODistributedServerManager.NODE_STATUS iStatus)
ODistributedServerManager	unregisterLifecycleListener(ODistributedLifecycleListener iListener)
boolean	updateCachedDatabaseConfiguration(java.lang.String iDatabaseName, OModifiableDistributedConfiguration cfg, boolean iDeployToCluster)
void	updateLastClusterChange()
void	waitUntilNodeOnline()
void	waitUntilNodeOnline(java.lang.String nodeName, java.lang.String databaseName)

Field Detail

FILE_DISTRIBUTED_DB_CONFIG

static final java.lang.String FILE_DISTRIBUTED_DB_CONFIG

See Also:

Constant Field Values

Method Detail

isNodeStatusEqualsTo

boolean isNodeStatusEqualsTo(java.lang.String iNodeName,
                             java.lang.String iDatabaseName,
                             ODistributedServerManager.DB_STATUS... statuses)

Checks the node status if it's one of the statuses received as argument.

Parameters:

iNodeName - Node name

iDatabaseName - Database name

statuses - vararg of statuses

Returns:

true if the node's status is equals to one of the passed statuses, otherwise false

isNodeAvailable

boolean isNodeAvailable(java.lang.String iNodeName)

getAvailableNodeNames

java.util.Set<java.lang.String> getAvailableNodeNames(java.lang.String databaseName)

getCoordinatorServer

@Deprecated
java.lang.String getCoordinatorServer()

Deprecated.

waitUntilNodeOnline

void waitUntilNodeOnline()
                  throws java.lang.InterruptedException

Throws:

java.lang.InterruptedException

waitUntilNodeOnline

void waitUntilNodeOnline(java.lang.String nodeName,
                         java.lang.String databaseName)
                  throws java.lang.InterruptedException

Throws:

java.lang.InterruptedException

getServerInstance

OServer getServerInstance()

isEnabled

boolean isEnabled()

registerLifecycleListener

ODistributedServerManager registerLifecycleListener(ODistributedLifecycleListener iListener)

unregisterLifecycleListener

ODistributedServerManager unregisterLifecycleListener(ODistributedLifecycleListener iListener)

executeOnLocalNode

java.lang.Object executeOnLocalNode(ODistributedRequestId reqId,
                                    ORemoteTask task,
                                    ODatabaseDocumentInternal database)

executeOnLocalNodeFromRemote

void executeOnLocalNodeFromRemote(ODistributedRequest request)

getRemoteServer

ORemoteServerController getRemoteServer(java.lang.String nodeName)
                                 throws java.io.IOException

Throws:

java.io.IOException

getConfigurationMap

java.util.Map<java.lang.String,java.lang.Object> getConfigurationMap()

getLastClusterChangeOn

long getLastClusterChangeOn()

getNodeStatus

ODistributedServerManager.NODE_STATUS getNodeStatus()

setNodeStatus

void setNodeStatus(ODistributedServerManager.NODE_STATUS iStatus)

checkNodeStatus

boolean checkNodeStatus(ODistributedServerManager.NODE_STATUS status)

removeServer

void removeServer(java.lang.String nodeLeftName,
                  boolean removeOnlyDynamicServers)

getDatabaseStatus

ODistributedServerManager.DB_STATUS getDatabaseStatus(java.lang.String iNode,
                                                      java.lang.String iDatabaseName)

setDatabaseStatus

void setDatabaseStatus(java.lang.String iNode,
                       java.lang.String iDatabaseName,
                       ODistributedServerManager.DB_STATUS iStatus)

getNodesWithStatus

int getNodesWithStatus(java.util.Collection<java.lang.String> iNodes,
                       java.lang.String databaseName,
                       ODistributedServerManager.DB_STATUS... statuses)

getMessageService

ODistributedMessageService getMessageService()

getDistributedStrategy

ODistributedStrategy getDistributedStrategy()

setDistributedStrategy

void setDistributedStrategy(ODistributedStrategy streatgy)

updateCachedDatabaseConfiguration

boolean updateCachedDatabaseConfiguration(java.lang.String iDatabaseName,
                                          OModifiableDistributedConfiguration cfg,
                                          boolean iDeployToCluster)

getNextMessageIdCounter

long getNextMessageIdCounter()

getNodeUuidByName

java.lang.String getNodeUuidByName(java.lang.String name)

updateLastClusterChange

void updateLastClusterChange()

reassignClustersOwnership

void reassignClustersOwnership(java.lang.String iNode,
                               java.lang.String databaseName,
                               OModifiableDistributedConfiguration cfg,
                               boolean canCreateNewClusters)

isNodeAvailable

boolean isNodeAvailable(java.lang.String iNodeName,
                        java.lang.String databaseName)

Available means not OFFLINE, so ONLINE or SYNCHRONIZING.

isNodeOnline

boolean isNodeOnline(java.lang.String iNodeName,
                     java.lang.String databaseName)

Returns true if the node status is ONLINE.

getTotalNodes

int getTotalNodes(java.lang.String iDatabaseName)

getAvailableNodes

int getAvailableNodes(java.lang.String iDatabaseName)

getAvailableNodes

int getAvailableNodes(java.util.Collection<java.lang.String> iNodes,
                      java.lang.String databaseName)

isOffline

boolean isOffline()

getLocalNodeId

int getLocalNodeId()

getLocalNodeName

java.lang.String getLocalNodeName()

getClusterConfiguration

com.orientechnologies.orient.core.record.impl.ODocument getClusterConfiguration()

getNodeNameById

java.lang.String getNodeNameById(int id)

getNodeIdByName

int getNodeIdByName(java.lang.String node)

getNodeConfigurationByUuid

com.orientechnologies.orient.core.record.impl.ODocument getNodeConfigurationByUuid(java.lang.String iNode,
                                                                                   boolean useCache)

getLocalNodeConfiguration

com.orientechnologies.orient.core.record.impl.ODocument getLocalNodeConfiguration()

getDatabaseConfiguration

ODistributedConfiguration getDatabaseConfiguration(java.lang.String iDatabaseName)

getDatabaseConfiguration

ODistributedConfiguration getDatabaseConfiguration(java.lang.String iDatabaseName,
                                                   boolean createIfNotPresent)

sendRequest

ODistributedResponse sendRequest(java.lang.String iDatabaseName,
                                 java.util.Collection<java.lang.String> iClusterNames,
                                 java.util.Collection<java.lang.String> iTargetNodeNames,
                                 ORemoteTask iTask,
                                 long messageId,
                                 ODistributedRequest.EXECUTION_MODE iExecutionMode,
                                 java.lang.Object localResult)

Sends a distributed request against multiple servers.

Parameters:

iDatabaseName -

iClusterNames -

iTargetNodeNames -

iTask -

messageId - Message Id as long

iExecutionMode -

localResult - It's the result of the request executed locally

Returns:

sendRequest

ODistributedResponse sendRequest(java.lang.String iDatabaseName,
                                 java.util.Collection<java.lang.String> iClusterNames,
                                 java.util.Collection<java.lang.String> iTargetNodeNames,
                                 ORemoteTask iTask,
                                 long messageId,
                                 ODistributedRequest.EXECUTION_MODE iExecutionMode,
                                 java.lang.Object localResult,
                                 ODistributedResponseManagerFactory responseManagerFactory)

getStats

com.orientechnologies.orient.core.record.impl.ODocument getStats()

convertException

java.lang.Throwable convertException(java.lang.Throwable original)

getOnlineNodes

java.util.List<java.lang.String> getOnlineNodes(java.lang.String iDatabaseName)

installDatabase

boolean installDatabase(boolean iStartup,
                        java.lang.String databaseName,
                        boolean forceDeployment,
                        boolean tryWithDeltaFirst)

getTaskFactoryManager

ORemoteTaskFactoryManager getTaskFactoryManager()

Returns the task factory manager. During first connect the minor version of the protocol is used.

getActiveServers

java.util.Set<java.lang.String> getActiveServers()

getClusterTime

long getClusterTime()

Returns the cluster-wide time in milliseconds.

Cluster tries to keep a cluster-wide time which might be different than the member's own system time. Cluster-wide time is -almost- the same on all members of the cluster.

getDefaultDatabaseConfigFile

java.io.File getDefaultDatabaseConfigFile()

getLockManagerRequester

ODistributedLockManager getLockManagerRequester()

getLockManagerExecutor

ODistributedLockManager getLockManagerExecutor()

executeInDistributedDatabaseLock

<T> T executeInDistributedDatabaseLock(java.lang.String databaseName,
                                       long timeoutLocking,
                                       OModifiableDistributedConfiguration lastCfg,
                                       com.orientechnologies.common.util.OCallable<T,OModifiableDistributedConfiguration> iCallback)

Executes an operation protected by a distributed lock (one per database).

Type Parameters:

T - Return type

Parameters:

databaseName - Database name

timeoutLocking -

iCallback - Operation @return The operation's result of type T

isWriteQuorumPresent

boolean isWriteQuorumPresent(java.lang.String databaseName)

Returns true if the quorum is present in terms of number of available nodes for full replication only. With sharding, instead, the quorum may depend on the involved clusters.

Returns:

notifyClients

void notifyClients(java.lang.String databaseName)

messageReceived

default void messageReceived(ODistributedRequest request)

messagePartitionCalculate

default void messagePartitionCalculate(ODistributedRequest request,
                                       java.util.Set<java.lang.Integer> involvedWorkerQueues)

messageBeforeOp

default void messageBeforeOp(java.lang.String op,
                             ODistributedRequestId requestId)

messageAfterOp

default void messageAfterOp(java.lang.String op,
                            ODistributedRequestId requestId)

messageCurrentPayload

default void messageCurrentPayload(ODistributedRequestId requestId,
                                   java.lang.Object responsePayload)

messageProcessStart

default void messageProcessStart(ODistributedRequest message)

messageProcessEnd

default void messageProcessEnd(ODistributedRequest iRequest,
                               java.lang.Object responsePayload)