splitBrain

Class ControllerListener

java.lang.Object

util.AbstractListener

splitBrain.ControllerListener

All Implemented Interfaces:

com.gemstone.gemfire.cache.CacheCallback, com.gemstone.gemfire.cache.CacheListener, com.gemstone.gemfire.cache.Declarable

Direct Known Subclasses:

CQListener, ForcedDiscListener, KnownKeysControllerListener, ParRegListener

public class ControllerListener
extends AbstractListener
implements com.gemstone.gemfire.cache.CacheListener, com.gemstone.gemfire.cache.Declarable

Listener to control a vm that becomes wither sick, slow, sick and dead, or slow and dead. How to use: Install this listener in a region in a vm where it is desired for that vm to beccome unhealthy in some way. When ready to cause unhealthiness, call any of: 1) ControllerBB.enableSlowListener(vmID) 2) ControllerBB.enableSickness(vmID) 4) ControllerBB.enableSlowListener(vmID) AND ControllerBB.enableDead(vmID) 5) ControllerBB.enableSickness(vmID) AND ControllerBB.enableDead(vmID) This makes the target vm ready to respond to unhealthiness, but it will not occur until an afterCreate event is invoked in the next step. Do a put from any vm such that it will invoke afterCreate on the target vm(s). The afterCreate call will wait until severe alerts are recognized for cases 1 and 2 and will wait until a forced disconnect occurs for cases 3 and 4, Call ControllerBB.reset(vmID) to clear the bb of any signals used. After this call, the given vm id can become slow again if desired. It is recommended that the user frequently call checkForError() to throw any errors detected by this listener. Notes: Only install this listener in one region per vm. It is not intended to work with multiple regions in a single vm. Don't forget to enable alerts in the product (it is off by default) by setting ack-severe-alert-threshold (this begins after ack-wait-threshold has elapsed).

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	validateForcedDisconnects

Fields inherited from class util.AbstractListener

CntrName_AfterCreate_isDist, CntrName_AfterCreate_isExp, CntrName_AfterCreate_isLoad, CntrName_AfterCreate_isLocalLoad, CntrName_AfterCreate_isNetLoad, CntrName_AfterCreate_isNetSearch, CntrName_AfterCreate_isNotDist, CntrName_AfterCreate_isNotExp, CntrName_AfterCreate_isNotLoad, CntrName_AfterCreate_isNotLocalLoad, CntrName_AfterCreate_isNotNetLoad, CntrName_AfterCreate_isNotNetSearch, CntrName_AfterCreate_isNotPutAll, CntrName_AfterCreate_isNotRemote, CntrName_AfterCreate_isPutAll, CntrName_AfterCreate_isRemote, CntrName_AfterDestroy_isDist, CntrName_AfterDestroy_isExp, CntrName_AfterDestroy_isLoad, CntrName_AfterDestroy_isLocalLoad, CntrName_AfterDestroy_isNetLoad, CntrName_AfterDestroy_isNetSearch, CntrName_AfterDestroy_isNotDist, CntrName_AfterDestroy_isNotExp, CntrName_AfterDestroy_isNotLoad, CntrName_AfterDestroy_isNotLocalLoad, CntrName_AfterDestroy_isNotNetLoad, CntrName_AfterDestroy_isNotNetSearch, CntrName_AfterDestroy_isNotRemote, CntrName_AfterDestroy_isRemote, CntrName_AfterInvalidate_isDist, CntrName_AfterInvalidate_isExp, CntrName_AfterInvalidate_isLoad, CntrName_AfterInvalidate_isLocalLoad, CntrName_AfterInvalidate_isNetLoad, CntrName_AfterInvalidate_isNetSearch, CntrName_AfterInvalidate_isNotDist, CntrName_AfterInvalidate_isNotExp, CntrName_AfterInvalidate_isNotLoad, CntrName_AfterInvalidate_isNotLocalLoad, CntrName_AfterInvalidate_isNotNetLoad, CntrName_AfterInvalidate_isNotNetSearch, CntrName_AfterInvalidate_isNotRemote, CntrName_AfterInvalidate_isRemote, CntrName_AfterRegionCreate_isDist, CntrName_AfterRegionCreate_isExp, CntrName_AfterRegionCreate_isNotDist, CntrName_AfterRegionCreate_isNotExp, CntrName_AfterRegionCreate_isNotRemote, CntrName_AfterRegionCreate_isRemote, CntrName_AfterRegionDestroy_isDist, CntrName_AfterRegionDestroy_isExp, CntrName_AfterRegionDestroy_isNotDist, CntrName_AfterRegionDestroy_isNotExp, CntrName_AfterRegionDestroy_isNotRemote, CntrName_AfterRegionDestroy_isRemote, CntrName_AfterRegionInvalidate_isDist, CntrName_AfterRegionInvalidate_isExp, CntrName_AfterRegionInvalidate_isNotDist, CntrName_AfterRegionInvalidate_isNotExp, CntrName_AfterRegionInvalidate_isNotRemote, CntrName_AfterRegionInvalidate_isRemote, CntrName_AfterRegionLive_isDist, CntrName_AfterRegionLive_isExp, CntrName_AfterRegionLive_isNotDist, CntrName_AfterRegionLive_isNotExp, CntrName_AfterRegionLive_isNotRemote, CntrName_AfterRegionLive_isRemote, CntrName_AfterUpdate_isDist, CntrName_AfterUpdate_isExp, CntrName_AfterUpdate_isLoad, CntrName_AfterUpdate_isLocalLoad, CntrName_AfterUpdate_isNetLoad, CntrName_AfterUpdate_isNetSearch, CntrName_AfterUpdate_isNotDist, CntrName_AfterUpdate_isNotExp, CntrName_AfterUpdate_isNotLoad, CntrName_AfterUpdate_isNotLocalLoad, CntrName_AfterUpdate_isNotNetLoad, CntrName_AfterUpdate_isNotNetSearch, CntrName_AfterUpdate_isNotPutAll, CntrName_AfterUpdate_isNotRemote, CntrName_AfterUpdate_isPutAll, CntrName_AfterUpdate_isRemote, CntrName_Close, whereIWasRegistered

Constructor Summary

Constructors

Constructor and Description
ControllerListener()

Method Summary

Modifier and Type	Method and Description
void	afterCreate(com.gemstone.gemfire.cache.EntryEvent event)
void	afterDestroy(com.gemstone.gemfire.cache.EntryEvent event)
void	afterDisconnect() Can be overridden in subclasses for reinitializing after forced disconnects.
void	afterInvalidate(com.gemstone.gemfire.cache.EntryEvent event)
void	afterRegionClear(com.gemstone.gemfire.cache.RegionEvent event)
void	afterRegionCreate(com.gemstone.gemfire.cache.RegionEvent event)
void	afterRegionDestroy(com.gemstone.gemfire.cache.RegionEvent event)
void	afterRegionInvalidate(com.gemstone.gemfire.cache.RegionEvent event)
void	afterRegionLive(com.gemstone.gemfire.cache.RegionEvent event)
void	afterUpdate(com.gemstone.gemfire.cache.EntryEvent event)
void	close()
protected void	doAfterCreate(com.gemstone.gemfire.cache.EntryEvent event) Listener invocation to control slow, sick and dead vms.
protected void	doAfterRegionDestroy(com.gemstone.gemfire.cache.RegionEvent event) Recognize a forced disconnect
void	init(Properties prop)
void	initAfterDisconnect() Can be overridden in subclasses for anything that needs to be done after a disconnect.
protected void	waitForFDThenInit(com.gemstone.gemfire.distributed.DistributedSystem ds, com.gemstone.gemfire.cache.Cache theCache) Wait for a ForcedDisconnect, wait for all threads in this vm to get exceptions, then reinitialize

Methods inherited from class util.AbstractListener

getNewValueStr, getOldValueStr, incrementAfterCreateCounters, incrementAfterCreateCounters, incrementAfterDestroyCounters, incrementAfterDestroyCounters, incrementAfterInvalidateCounters, incrementAfterInvalidateCounters, incrementAfterRegionCreateCounters, incrementAfterRegionCreateCounters, incrementAfterRegionDestroyCounters, incrementAfterRegionDestroyCounters, incrementAfterRegionInvalidateCounters, incrementAfterRegionInvalidateCounters, incrementAfterRegionLiveCounters, incrementAfterRegionLiveCounters, incrementAfterUpdateCounters, incrementAfterUpdateCounters, incrementCloseCounter, logCall, logCQEvent, logCQEventAsSummary, logTxEvent, toString, toString, toString, toString

Methods inherited from class java.lang.Object

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

Field Detail

validateForcedDisconnects

public static boolean validateForcedDisconnects

Constructor Detail

ControllerListener

public ControllerListener()

Method Detail

afterDestroy

public void afterDestroy(com.gemstone.gemfire.cache.EntryEvent event)

Specified by:

afterDestroy in interface com.gemstone.gemfire.cache.CacheListener

afterInvalidate

public void afterInvalidate(com.gemstone.gemfire.cache.EntryEvent event)

Specified by:

afterInvalidate in interface com.gemstone.gemfire.cache.CacheListener

afterUpdate

public void afterUpdate(com.gemstone.gemfire.cache.EntryEvent event)

Specified by:

afterUpdate in interface com.gemstone.gemfire.cache.CacheListener

afterRegionInvalidate

public void afterRegionInvalidate(com.gemstone.gemfire.cache.RegionEvent event)

Specified by:

afterRegionInvalidate in interface com.gemstone.gemfire.cache.CacheListener

afterRegionClear

public void afterRegionClear(com.gemstone.gemfire.cache.RegionEvent event)

Specified by:

afterRegionClear in interface com.gemstone.gemfire.cache.CacheListener

afterRegionCreate

public void afterRegionCreate(com.gemstone.gemfire.cache.RegionEvent event)

Specified by:

afterRegionCreate in interface com.gemstone.gemfire.cache.CacheListener

afterRegionLive

public void afterRegionLive(com.gemstone.gemfire.cache.RegionEvent event)

Specified by:

afterRegionLive in interface com.gemstone.gemfire.cache.CacheListener

init

public void init(Properties prop)

Specified by:

init in interface com.gemstone.gemfire.cache.Declarable

close

public void close()

Specified by:

close in interface com.gemstone.gemfire.cache.CacheCallback

afterCreate

public void afterCreate(com.gemstone.gemfire.cache.EntryEvent event)

Specified by:

afterCreate in interface com.gemstone.gemfire.cache.CacheListener

doAfterCreate

protected void doAfterCreate(com.gemstone.gemfire.cache.EntryEvent event)

Listener invocation to control slow, sick and dead vms.

afterRegionDestroy

public void afterRegionDestroy(com.gemstone.gemfire.cache.RegionEvent event)

Specified by:

afterRegionDestroy in interface com.gemstone.gemfire.cache.CacheListener

doAfterRegionDestroy

protected void doAfterRegionDestroy(com.gemstone.gemfire.cache.RegionEvent event)

Recognize a forced disconnect

initAfterDisconnect

public void initAfterDisconnect()

Can be overridden in subclasses for anything that needs to be done after a disconnect.

afterDisconnect

public void afterDisconnect()

Can be overridden in subclasses for reinitializing after forced disconnects.

waitForFDThenInit

protected void waitForFDThenInit(com.gemstone.gemfire.distributed.DistributedSystem ds,
                                 com.gemstone.gemfire.cache.Cache theCache)

Wait for a ForcedDisconnect, wait for all threads in this vm to get exceptions, then reinitialize