NetworkPartitionTest (GemFire XD Java API Documentation)

java.lang.Object
- util.OperationsClient
- - splitBrain.NetworkPartitionTest

```
public class NetworkPartitionTest
extends OperationsClient
```
Test to execute entry operations while killing coordinators, lead members and the like.

Since:

5.5

See Also:

SplitBrainPrms, SplitBrainBB

Field Summary

Fields
Modifier and Type Field and Description

protected static boolean forcedDisconnect

protected static NetworkPartitionTest testInstance
- Fields inherited from class util.OperationsClient
  createCallbackPrefix, destroyCallbackPrefix, distLockService, ENTRY_ADD_OPERATION, ENTRY_DESTROY_OPERATION, ENTRY_GET_NEW_OPERATION, ENTRY_GET_OPERATION, ENTRY_INVALIDATE_OPERATION, ENTRY_LOCAL_DESTROY_OPERATION, ENTRY_LOCAL_INVALIDATE_OPERATION, ENTRY_PUTALL_OPERATION, ENTRY_UPDATE_OPERATION, getCallbackPrefix, invalidateCallbackPrefix, LOCK_NAME, LOCK_SERVICE_NAME, lockOperations, lowerThreshold, minTaskGranularityMS, minTaskGranularitySec, numOpsPerTask, PUT_IF_ABSENT_OPERATION, randomValues, regionDestroyCallbackPrefix, regionInvalidateCallbackPrefix, REMOVE_OPERATION, REPLACE_OPERATION, updateCallbackPrefix, upperThreshold, useTransactions, VmIDStr

Fields
Modifier and Type	Field and Description
`protected static boolean`	`forcedDisconnect`
`protected static NetworkPartitionTest`	`testInstance`

Constructor Summary

Constructors
Constructor and Description

NetworkPartitionTest()

Constructors
Constructor and Description
`NetworkPartitionTest()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`closeCacheAndDisconnectFromDS()` Close the cache (and disconnect from the DS) This should prevent the ShutdownException: no down protocol available! during Shutdown (if locators (client vms) are shut down prior to application client vms
`protected void`	`createGatewayHub()`
`static void`	`createLocatorTask()` Creates a (disconnected) locator and does not throw an exception if it already exists.
`protected void`	`doEntryOperations()`
`static String`	`getXmlFileName()` Return the xml file name for the vm with the given ID.
`static void`	`HydraCloseTask_checkForRegionDestroyedForcedDisconnects()` CLOSETASK to check static forcedDisconect (meaning that we processed a RegionDestroyedException.FORCED_DISCONNECT in the listener.
`static void`	`HydraEndTask_verifyLosingPartition()` ENDTASK to verify that all clients in the losing partition posted to the forcedDisconnectList on the blackboard Also verifies proper receipt of SystemMembershipListener memberCrashed events.
`static void`	`HydraEndTask_verifyReconnect()` ENDTASK to verify that all clients in the losing partition posted to the reconnected bb
`static void`	`HydraEndTask_waitForReconnect()` ENDTASK to wait for distributed system to reconnect
`static void`	`HydraTask_addAdminFailureListener()` Task to add a MembershipTestHook to listen for membership failures
`static void`	`HydraTask_addExpectForcedDisconnectClient()` If appropriate, adds this client to the set that are expected to receive a forced-disconnect.
`static void`	`HydraTask_connectToDS()`
`static void`	`HydraTask_createGatewaySenderIds()` Creates GatewaySender ids based on the `ConfigPrms.gatewaySenderConfig`.
`static void`	`HydraTask_createSnapshot()` Hydra task to create a blackboard snapshot of the region contents
`static void`	`HydraTask_doEntryOperations()` Performs puts/gets on entries in TestRegion Allows Shutdown and CacheClosedException if the result of forcedDisconnect
`static void`	`HydraTask_initialize()` Create the cache and Region.
`static void`	`HydraTask_initializeBridgeClient()`
`static void`	`HydraTask_initializeBridgeServer()`
`static void`	`HydraTask_initializeFromXML()` Create the cache and Region.
`static void`	`HydraTask_initWanComponents()` Creates start new wan components i.e senders based on `ConfigPrms.gatewaySenderConfig` and receivers based on `ConfigPrms.gatewayReceiverConfig`.
`static void`	`HydraTask_loadRegion()` loadRegion
`static void`	`HydraTask_verifyAdminFailures()` Task to verify that the correct number of admins got forced disconnects
`static void`	`HydraTask_verifyRegion()` Task to verify that the region recovered data from disk (it's size is not 0)
`protected void`	`initialize()`
`protected void`	`initializeBridgeClient()`
`protected void`	`initializeBridgeServer()`
`protected void`	`initializeFromXML()`
`protected void`	`initializePrms()`
`protected void`	`loadRegion()` loads the test region with SplitBrainBB.maxKeys entries.
`protected void`	`reconnected()` call this when the cache has been reconnected after a forced-disconnect
`protected boolean`	`requiresPersistence(RegionDescription rd)`
`static void`	`setForcedDisconnect()` API for SBListener to set the forcedDisconnect flag to indicate that a RegionDestroyedEvent (FORCED_DISCONNECT) has been processed in this VM.
`static void`	`startAndConnectLocatorTask()` Connects a locator to its distributed system and does not throw an exception if already connected.
`static void`	`startGatewayHubTask()` Starts a gateway hub in a VM that previously created one, after creating gateways
`protected boolean`	`waitForReconnect()`

Methods inherited from class util.OperationsClient
addEntry, destroyEntry, doEntryOperations, getExistingKey, getExistingKeys, getKey, getNewKey, getNewKey, getOperation, getRecentKey, getUpdateObject, getValueForKey, initializeOperationsClient, invalidateEntry, putAll, putIfAbsent, remove, remove, replace, replace, stopLocatorTask, updateEntry

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - forcedDisconnect
```
protected static boolean forcedDisconnect
```
  - testInstance
```
protected static NetworkPartitionTest testInstance
```
- Constructor Detail
  - NetworkPartitionTest
```
public NetworkPartitionTest()
```
- Method Detail
  - HydraTask_initializeBridgeServer
```
public static void HydraTask_initializeBridgeServer()
```
  - initializeBridgeServer
```
protected void initializeBridgeServer()
```
  - getXmlFileName
```
public static String getXmlFileName()
```
    Return the xml file name for the vm with the given ID.
  - HydraTask_initializeBridgeClient
```
public static void HydraTask_initializeBridgeClient()
```
  - initializeBridgeClient
```
protected void initializeBridgeClient()
```
  - HydraTask_connectToDS
```
public static void HydraTask_connectToDS()
```
  - HydraTask_initialize
```
public static void HydraTask_initialize()
```
    Create the cache and Region. Check for forced disconnects (for gii tests)
  - HydraTask_initializeFromXML
```
public static void HydraTask_initializeFromXML()
```
    Create the cache and Region. Check for forced disconnects (for gii tests)
  - HydraTask_addExpectForcedDisconnectClient
```
public static void HydraTask_addExpectForcedDisconnectClient()
```
    If appropriate, adds this client to the set that are expected to receive a forced-disconnect.
  - initialize
```
protected void initialize()
```
  - initializeFromXML
```
protected void initializeFromXML()
```
  - reconnected
```
protected void reconnected()
```
    call this when the cache has been reconnected after a forced-disconnect
  - HydraTask_createSnapshot
```
public static void HydraTask_createSnapshot()
```
    Hydra task to create a blackboard snapshot of the region contents
  - requiresPersistence
```
protected boolean requiresPersistence(RegionDescription rd)
```
  - createGatewayHub
```
protected void createGatewayHub()
```
  - initializePrms
```
protected void initializePrms()
```
  - startGatewayHubTask
```
public static void startGatewayHubTask()
```
    Starts a gateway hub in a VM that previously created one, after creating gateways
  - HydraTask_createGatewaySenderIds
```
public static void HydraTask_createGatewaySenderIds()
```
    Creates GatewaySender ids based on the ConfigPrms.gatewaySenderConfig.
  - HydraTask_initWanComponents
```
public static void HydraTask_initWanComponents()
```
    Creates start new wan components i.e senders based on ConfigPrms.gatewaySenderConfig and receivers based on ConfigPrms.gatewayReceiverConfig.
  - HydraTask_loadRegion
```
public static void HydraTask_loadRegion()
```
    loadRegion
  - loadRegion
```
protected void loadRegion()
```
    loads the test region with SplitBrainBB.maxKeys entries. Note that this task can be accomplished by multiple threads.
  - HydraTask_doEntryOperations
```
public static void HydraTask_doEntryOperations()
```
    Performs puts/gets on entries in TestRegion Allows Shutdown and CacheClosedException if the result of forcedDisconnect
  - doEntryOperations
```
protected void doEntryOperations()
```
  - waitForReconnect
```
protected boolean waitForReconnect()
```
  - closeCacheAndDisconnectFromDS
```
public static void closeCacheAndDisconnectFromDS()
```
    Close the cache (and disconnect from the DS) This should prevent the ShutdownException: no down protocol available! during Shutdown (if locators (client vms) are shut down prior to application client vms
  - setForcedDisconnect
```
public static void setForcedDisconnect()
```
    API for SBListener to set the forcedDisconnect flag to indicate that a RegionDestroyedEvent (FORCED_DISCONNECT) has been processed in this VM.
  - HydraCloseTask_checkForRegionDestroyedForcedDisconnects
```
public static void HydraCloseTask_checkForRegionDestroyedForcedDisconnects()
```
    CLOSETASK to check static forcedDisconect (meaning that we processed a RegionDestroyedException.FORCED_DISCONNECT in the listener. If so, add to the list of disconnectedClients. (We cannot do this is the listener thread itself as the blackboard lock (to synchronize between VMs) requires a RemoteTestModule thread (and the listener thread is not one of our logical hydra task threads). Mainly used by bridgeServer VMs and gii loadClient VMs (since they do not current have TASKS assigned).
  - HydraEndTask_verifyLosingPartition
```
public static void HydraEndTask_verifyLosingPartition()
```
    ENDTASK to verify that all clients in the losing partition posted to the forcedDisconnectList on the blackboard Also verifies proper receipt of SystemMembershipListener memberCrashed events.
  - HydraTask_verifyRegion
```
public static void HydraTask_verifyRegion()
```
    Task to verify that the region recovered data from disk (it's size is not 0)
  - HydraTask_addAdminFailureListener
```
public static void HydraTask_addAdminFailureListener()
```
    Task to add a MembershipTestHook to listen for membership failures
  - HydraTask_verifyAdminFailures
```
public static void HydraTask_verifyAdminFailures()
```
    Task to verify that the correct number of admins got forced disconnects
  - HydraEndTask_waitForReconnect
```
public static void HydraEndTask_waitForReconnect()
```
    ENDTASK to wait for distributed system to reconnect
  - HydraEndTask_verifyReconnect
```
public static void HydraEndTask_verifyReconnect()
```
    ENDTASK to verify that all clients in the losing partition posted to the reconnected bb
  - createLocatorTask
```
public static void createLocatorTask()
```
    Creates a (disconnected) locator and does not throw an exception if it already exists.
  - startAndConnectLocatorTask
```
public static void startAndConnectLocatorTask()
```
    Connects a locator to its distributed system and does not throw an exception if already connected.

Class NetworkPartitionTest

Field Summary

Fields inherited from class util.OperationsClient

Constructor Summary

Method Summary

Methods inherited from class util.OperationsClient

Methods inherited from class java.lang.Object

Field Detail

forcedDisconnect

testInstance

Constructor Detail

NetworkPartitionTest

Method Detail

HydraTask_initializeBridgeServer

initializeBridgeServer

getXmlFileName

HydraTask_initializeBridgeClient

initializeBridgeClient

HydraTask_connectToDS

HydraTask_initialize

HydraTask_initializeFromXML

HydraTask_addExpectForcedDisconnectClient

initialize

initializeFromXML

reconnected

HydraTask_createSnapshot

requiresPersistence

createGatewayHub

initializePrms

startGatewayHubTask

HydraTask_createGatewaySenderIds

HydraTask_initWanComponents

HydraTask_loadRegion

loadRegion

HydraTask_doEntryOperations

doEntryOperations

waitForReconnect

closeCacheAndDisconnectFromDS

setForcedDisconnect

HydraCloseTask_checkForRegionDestroyedForcedDisconnects

HydraEndTask_verifyLosingPartition

HydraTask_verifyRegion

HydraTask_addAdminFailureListener

HydraTask_verifyAdminFailures

HydraEndTask_waitForReconnect

HydraEndTask_verifyReconnect

createLocatorTask

startAndConnectLocatorTask