com.sleepycat.je.rep

Class InsufficientLogException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.sleepycat.je.DatabaseException

com.sleepycat.je.RunRecoveryException

com.sleepycat.je.EnvironmentFailureException

com.sleepycat.je.rep.RestartRequiredException

com.sleepycat.je.rep.InsufficientLogException

All Implemented Interfaces:

Serializable

public class InsufficientLogException
extends RestartRequiredException

This exception indicates that the log files constituting the Environment are insufficient and cannot be used as the basis for continuing with the replication stream provided by the current master.

This exception is typically thrown by the ReplicatedEnvironment constructor when a node has been down for a long period of time and is being started up again. It may also be thrown when a brand new node attempts to become a member of the group and it does not have a sufficiently current set of log files. If the group experiences sustained network connectivity problems, this exception may also be thrown by an active Replica that has been unable to stay in touch with the members of its group for an extended period of time.

In the typical case, application handles the exception by invoking NetworkRestore.execute(com.sleepycat.je.rep.InsufficientLogException, com.sleepycat.je.rep.NetworkRestoreConfig) to obtain the log files it needs from one of the members of the replication group. After the log files are obtained, the node recreates its environment handle and resumes participation as an active member of the group.

See Also:

NetworkRestore, Serialized Form

Constructor Summary

Constructors

Constructor and Description
InsufficientLogException(Properties restoreProperties, String helperHosts, ReplicationNetworkConfig repNetConfig)
InsufficientLogException(RepImpl repImpl, VLSN refreshVLSN)
InsufficientLogException(RepNode repNode, Set<ReplicationNode> logProviders)
InsufficientLogException(String message) For KVS test use only.

Method Summary

Modifier and Type	Method and Description
Set<ReplicationNode>	getLogProviders() Returns the members of the replication group that can serve as candidate log providers to supply the logs needed by this node.
Properties	getProperties() For internal use only.
RepImpl	getRepImpl() For internal use only.
String	toString()
EnvironmentFailureException	wrapSelf(String msg) For internal use only.

Methods inherited from class com.sleepycat.je.EnvironmentFailureException

assertState, assertState, getMessage, getReason, isCorrupted, makeJavaErrorWrapper, promote, setAlreadyThrown, unexpectedException, unexpectedException, unexpectedException, unexpectedException, unexpectedState, unexpectedState, unexpectedState, unexpectedState

Methods inherited from class com.sleepycat.je.DatabaseException

addErrorMessage, addRethrownStackTrace, getVersionHeader

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

InsufficientLogException

public InsufficientLogException(String message)

For KVS test use only.

InsufficientLogException

public InsufficientLogException(RepNode repNode,
                                Set<ReplicationNode> logProviders)

InsufficientLogException

public InsufficientLogException(RepImpl repImpl,
                                VLSN refreshVLSN)

InsufficientLogException

public InsufficientLogException(Properties restoreProperties,
                                String helperHosts,
                                ReplicationNetworkConfig repNetConfig)

Parameters:

restoreProperties - the properties extracted from the RestoreRequired record in the log

helperHosts - extra helper hosts are derived from those used to open the environment.

repNetConfig - the network configuration to use when contacting log suppliers for jdb files.

Method Detail

wrapSelf

public EnvironmentFailureException wrapSelf(String msg)

For internal use only.

Specified by:

wrapSelf in class RestartRequiredException

getLogProviders

public Set<ReplicationNode> getLogProviders()

Returns the members of the replication group that can serve as candidate log providers to supply the logs needed by this node.

Returns:

a list of members that can provide logs

getRepImpl

public RepImpl getRepImpl()

For internal use only.

toString

public String toString()

Overrides:

toString in class Throwable

getProperties

public Properties getProperties()

For internal use only.