DistributedTestCase (GemFire XD Java API Documentation)

java.lang.Object
- junit.framework.Assert
- - junit.framework.TestCase
  - - dunit.DistributedTestCase

All Implemented Interfaces:

Serializable, junit.framework.Test

Direct Known Subclasses:

AdminOnDsDUnitTest, BackwardCompatibilityCommandDUnitTest, BackwardCompatibilityDUnitTest, BackwardCompatibilityHandshakeDUnitTest, BackwardCompatibilityHigherVersionClientDUnitTest, BackwardCompatibilityMessageDUnitTest, BasicTest, BlockingTimeOutDUnitTest, Bug33359DUnitTest, Bug33726DUnitTest, Bug36269DUnitTest, Bug36457DUnitTest, Bug36805DUnitTest, Bug36829DUnitTest, Bug36995DUnitTest, Bug37210DUnitTest, Bug37241DUnitTest, Bug37805DUnitTest, Bug40396DUnitTest, CacheMapTxnDUnitTest, CacheRegionClearStatsDUnitTest, CacheServerTestUtil, CacheServerTransactionsDUnitTest, CacheTestCase, CacheTimeSlowDownDUnitTest, ClearDAckDUnitTest, ClearGlobalDUnitTest, ClearMultiVmCallBkDUnitTest, ClearMultiVmDUnitTest, ClearPropagationDUnitTest, ClientAuthenticationDUnitTest, ClientAuthorizationTestBase, ClientConflationDUnitTest, ClientHealthStatsDUnitTest, ClientInterestNotifyDUnitTest, ClientToServerDeltaDUnitTest, ColocationFailoverDUnitTest, CompactRangeIndexDUnitTest, ConcurrentIndexUpdateWithInplaceObjectModFalseDUnitTest, ConcurrentIndexUpdateWithoutWLDUnitTest, ConflationDUnitTest, CQListGIIDUnitTest, DataSerializerPropogationDUnitTest, DataSourceJTADUnitTest, DeltaPropagationDUnitTest, DeltaPropagationStatsDUnitTest, DeltaPropagationWithCQDUnitTest, DeltaPropgationWanValidationDUnitTest, DeltaToRegionRelationCQRegistrationDUnitTest, DeltaToRegionRelationDUnitTest, DestroyEntryPropagationDUnitTest, DistAckMapMethodsDUnitTest, DistributedCacheTestCase, DistributedLockServiceTest, DistributedMemberTest, DistributedRegionFunctionExecutionDUnitTest, DistributedSystemIdDUnitTest, DistributedSystemTest, DistributionAdvisorTest, DistributionLocatorDUnitTest, DistributionManagerTest, DistributionManagerTimeDUnitTest, DurableClientDUnitTest, DurableClientReconnectDUnitTest, DurableClientStatsDUnitTest, DurableRegistrationDUnitTest, DurableResponseMatrixDUnitTest, EventIdOptimizationDUnitTest, EventIDVerificationDUnitTest, EventIDVerificationInP2PDUnitTest, ExceptionsDUnitTest, FailoverDUnitTest, FixedPartitioningTestBase, GemFireTimeSyncProtocolDUnitTest, GemFireTimeSyncServiceDUnitTest, GridAdvisorDUnitTest, HABug36738DUnitTest, HABug36773DUnitTest, HABugInPutDUnitTest, HAClearDUnitTest, HADispatcherDUnitTest, HADuplicateDUnitTest, HAEventIdPropagationDUnitTest, HAExpiryDUnitTest, HAGIIBugDUnitTest, HAGIIDUnitTest, HAInterestBaseTest, HAOverflowMemObjectSizerDUnitTest, HARegionDUnitTest, HARegionQueueDUnitTest, HARQueueNewImplDUnitTest, HashIndexDUnitTest, HASlowReceiverDUnitTest, HAStartupAndFailoverDUnitTest, HelloTest, IdleTimeOutDUnitTest, InstantiatorPropogationDUnitTest, InterestListDUnitTest, InterestListEndpointDUnitTest, InterestListFailoverDUnitTest, InterestListRecoveryDUnitTest, InterestResultPolicyDUnitTest, JavaGroupsTest, JTADUnitTest, LocalDistributionManagerTest, LocalFunctionExecutionDUnitTest, LocalProcessControllerDUnitTest, LocalProcessLauncherDUnitTest, LocatorTest, LocatorTestBase, LoginTimeOutDUnitTest, ManagementTestBase, MaxPoolSizeDUnitTest, MessagingPerf, NewRegionAttributesDUnitTest, OnGroupsFunctionExecutionDUnitTest, OperationsPropagationDUnitTest, P2PAuthenticationDUnitTest, P2PDeltaPropagationDUnitTest, PRDeltaPropagationDUnitTest, ProductUseLogDUnitTest, PutAllCallBkRemoteVMDUnitTest, PutAllCallBkSingleVMDUnitTest, PutAllDAckDUnitTest, PutAllDUnitTest, PutAllGlobalDUnitTest, PutAllMultiVmDUnitTest, QueryIndexDUnitTest, RedundancyLevelTestBase, RegionCloseDUnitTest, RegisterInterestBeforeRegionCreationDUnitTest, RegisterInterestKeysDUnitTest, ReliableMessagingDUnitTest, RemoteBlockingQueueTest, RemoveDAckDUnitTest, RemoveGlobalDUnitTest, RMIBindSamePortDifferentNICDUnitTest, RoleTest, RollingUpgradeDUnitTest, SecurityTestUtil, StatsBugDUnitTest, StreamingOperationManyDUnitTest, StreamingOperationOneDUnitTest, SystemAdminDUnitTest, TcpServerBackwardCompatDUnitDisabledTest, TestClientIdsDUnitTest, TestFailure, TestSubscriptionsDUnitTest, TransactionTimeOutDUnitTest, TxnManagerMultiThreadDUnitTest, TxnTimeOutDUnitTest, UnregisterInterestDUnitTest, UpdatePropagationDUnitTest, UpdateVersionDUnitTest, VerifyEventIDGenerationInP2PDUnitTest, VerifyUpdatesFromNonInterestEndPointDUnitTest, VMTest, WanBackwardCompatibleDUnitTest, WanDUnitTest, WANTestBase, WanTXValidationDUnitTest
```
public abstract class DistributedTestCase
extends junit.framework.TestCase
implements Serializable
```
This class is the superclass of all distributed unit tests.

See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`DistributedTestCase.ExpectedException` A class that represents an currently logged expected exception, which should be removed
`static interface`	`DistributedTestCase.WaitCriterion`
`static interface`	`DistributedTestCase.WaitCriterion2`

Field Summary

Fields
Modifier and Type	Field and Description
`static boolean`	`logPerTest`
`static boolean`	`reconnect`
`static com.gemstone.gemfire.distributed.internal.InternalDistributedSystem`	`system` This VM's connection to the distributed system
`static String`	`testName`

Constructor Summary

Constructors
Constructor and Description

DistributedTestCase(String name)
Creates a new DistributedTestCase test with the given name.

Constructors
Constructor and Description
`DistributedTestCase(String name)` Creates a new `DistributedTestCase` test with the given name.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static DistributedTestCase.ExpectedException`	`addExpectedException(String exception)` Log in all VMs, in both the Hydra logger and the GemFire logger the expected exception string to prevent grep logs from complaining.
`static DistributedTestCase.ExpectedException`	`addExpectedException(String exception, VM v)` Log in all VMs, in both the Hydra logger and the GemFire logger the expected exception string to prevent grep logs from complaining.
`protected static void`	`addHydraProperties(Properties config)` Fetches the GemFireDescription for this test and adds its DistributedSystem properties to the provided props parameter.
`void`	`attachDebugger(VM vm, String msg)`
`static void`	`checkBBFlag(String name, int expectedValue)`
`static void`	`cleanupAllVms()`
`static void`	`clearBBFlag(String name)`
`void`	`crashDistributedSystem(com.gemstone.gemfire.distributed.DistributedSystem msys)` Crash the cache in the given VM in such a way that it immediately stops communicating with peers.
`boolean`	`crashDistributedSystem(VM vm)` Crash the cache in the given VM in such a way that it immediately stops communicating with peers.
`protected static com.gemstone.gemfire.LogWriter`	`createLogWriter(Properties config)` Creates a new LogWriter and adds it to the config properties.
`protected static void`	`disconnectAllFromDS()`
`static void`	`disconnectFromDS()` Disconnects this VM from the distributed system
`static void`	`dumpAllStacks()` print stack dumps for all vms
`static void`	`dumpMyThreads(com.gemstone.gemfire.LogWriter logger)` Dump all thread stacks
`static void`	`dumpStack()` print a stack dump for this vm
`static void`	`dumpStack(Host host)` print stack dumps for all vms on the given host
`static void`	`dumpStack(VM vm)` print a stack dump for the given vm
`static void`	`dumpStackTrace(Thread t, StackTraceElement[] stack, com.gemstone.gemfire.LogWriter logger)`
`static void`	`fail(String message, Throwable ex)` Helper method that causes this test to fail because of the given exception.
`Properties`	`getAllDistributedSystemProperties(Properties props)`
`Properties`	`getDistributedSystemProperties()` Returns a `Properties` object used to configure a connection to a `DistributedSystem`.
`static String`	`getDUnitLocatorAddress()` Get the address that the standard dunit locator is listening on.
`static int`	`getDUnitLocatorPort()` Get the port that the standard dunit locator is listening on.
`static String`	`getDUnitLocatorString()`
`static String`	`getDUnitLogLevel()` This finds the log level configured for the test run.
`static String`	`getIPLiteral()` get the IP literal name for the current host, use this instead of "localhost" to avoid IPv6 name resolution bugs in the JDK/machine config.
`static com.gemstone.gemfire.LogWriter`	`getLogWriter()` Returns a `LogWriter` for logging information
`com.gemstone.gemfire.distributed.internal.InternalDistributedSystem`	`getLonerSystem()` Returns a loner distributed system that isn't connected to other vms
`com.gemstone.gemfire.distributed.internal.InternalDistributedSystem`	`getMcastSystem()` Returns an mcast distributed system that is connected to other vms using a random mcast port.
`com.gemstone.gemfire.distributed.internal.InternalDistributedSystem`	`getMcastSystem(int jgroupsPort)` Returns an mcast distributed system that is connected to other vms using the given mcast port.
`protected long`	`getRepeatTimeoutMs()` The number of milliseconds to try repeating validation code in the event that AssertionFailedError is thrown.
`static String`	`getServerHostName(Host host)` get the host name to use for a server cache in client/server dunit testing
`com.gemstone.gemfire.distributed.internal.InternalDistributedSystem`	`getSystem()` Returns this VM's connection to the distributed system.
`com.gemstone.gemfire.distributed.internal.InternalDistributedSystem`	`getSystem(Properties props)` Returns this VM's connection to the distributed system.
`protected Class`	`getTestClass()`
`static String`	`getTestName()`
`String`	`getUniqueName()` Returns a unique name for this test method.
`protected static int`	`getVMCount()` Return the total number of VMs on all hosts
`static void`	`incBBFlag(String name)`
`protected static void`	`invokeInEveryVM(Class c, String method)` Invokes a method in every remote VM that DUnit knows about.
`protected static void`	`invokeInEveryVM(Class c, String method, Object[] methodArgs)` Invokes a method in every remote VM that DUnit knows about.
`protected static Map`	`invokeInEveryVM(SerializableCallable work)` Invokes a `SerializableCallable` in every VM that DUnit knows about.
`static void`	`invokeInEveryVM(SerializableRunnable work)` Invokes a `SerializableRunnable` in every VM that DUnit knows about.
`protected void`	`invokeInEveryVMRepeatingIfNecessary(RepeatableRunnable work)` Invokes a `SerializableRunnable` in every VM that DUnit knows about.
`static void`	`invokeInLocator(SerializableRunnable work)`
`protected void`	`invokeRepeatingIfNecessary(VM vm, RepeatableRunnable task)`
`boolean`	`isConnectedToDS()` Returns whether or this VM is connected to a `DistributedSystem`.
`static void`	`join(Thread t, long ms, com.gemstone.gemfire.LogWriter logger)` Wait for a thread to join
`static String`	`noteTiming(long operations, String operationUnit, long beginTime, long endTime, String timeUnit)`
`protected void`	`pause()` pause for a default interval
`static void`	`pause(int ms)` pause for specified ms interval Make sure system clock has advanced by the specified number of millis before returning.
`static void`	`perVMSetUp(String name, String defaultDiskStoreName)`
`protected void`	`realTearDown()`
`protected static void`	`setDiskStoreForGateway(com.gemstone.gemfire.cache.Cache cache, String gatewayId, com.gemstone.gemfire.cache.util.GatewayQueueAttributes queueAttributes)`
`void`	`setSystem(Properties props, com.gemstone.gemfire.distributed.DistributedSystem ds)`
`static void`	`setTestName(String name)`
`void`	`setUp()` Sets up the test (noop).
`static void`	`staticPause(int ms)` Use of this function indicates a place in the tests tree where t he use of Thread.sleep() is highly questionable.
`void`	`tearDown()` For logPerTest to work, we have to disconnect from the DS, but all subclasses do not call super.tearDown().
`void`	`tearDown2()` Tears down the test.
`static void`	`unregisterAllDataSerializersFromAllVms()`
`static void`	`unregisterDataSerializerInThisVM()`
`static void`	`unregisterInstantiatorsInThisVM()`
`static void`	`waitForBBFlag(String name, int expectedValue, long timeout)`
`static void`	`waitForCriterion(DistributedTestCase.WaitCriterion ev, long ms, long interval, boolean throwOnTimeout)` Wait until given criterion is met
`static void`	`waitMutex(DistributedTestCase.WaitCriterion ev, Object mutex, long ms, long interval, boolean throwOnTimeout)` Wait on a mutex.

Methods inherited from class junit.framework.TestCase
assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertFalse, assertFalse, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, assertTrue, assertTrue, countTestCases, createResult, fail, fail, failNotEquals, failNotSame, failSame, format, getName, run, run, runBare, runTest, setName, toString

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

- Field Detail
  - system
```
public static com.gemstone.gemfire.distributed.internal.InternalDistributedSystem system
```
    This VM's connection to the distributed system
  - testName
```
public static volatile String testName
```
  - reconnect
```
public static boolean reconnect
```
  - logPerTest
```
public static final boolean logPerTest
```
- Constructor Detail
  - DistributedTestCase
```
public DistributedTestCase(String name)
```
    Creates a new DistributedTestCase test with the given name.
- Method Detail
  - attachDebugger
```
public void attachDebugger(VM vm,
                           String msg)
```
  - invokeInEveryVM
```
public static void invokeInEveryVM(SerializableRunnable work)
```
    Invokes a SerializableRunnable in every VM that DUnit knows about.
    
    See Also:
    
    VM.invoke(Runnable)
  - invokeInLocator
```
public static void invokeInLocator(SerializableRunnable work)
```
  - invokeInEveryVM
```
protected static Map invokeInEveryVM(SerializableCallable work)
```
    Invokes a SerializableCallable in every VM that DUnit knows about.
    
    Returns:
    
    a Map of results, where the key is the VM and the value is the result
    
    See Also:
    
    VM.invoke(Callable)
  - invokeInEveryVM
```
protected static void invokeInEveryVM(Class c,
                                      String method)
```
    Invokes a method in every remote VM that DUnit knows about.
    
    See Also:
    
    VM.invoke(Class, String)
  - invokeInEveryVM
```
protected static void invokeInEveryVM(Class c,
                                      String method,
                                      Object[] methodArgs)
```
    Invokes a method in every remote VM that DUnit knows about.
    
    See Also:
    
    VM.invoke(Class, String)
  - getRepeatTimeoutMs
```
protected long getRepeatTimeoutMs()
```
    The number of milliseconds to try repeating validation code in the event that AssertionFailedError is thrown. For ACK scopes, no repeat should be necessary.
  - invokeRepeatingIfNecessary
```
protected void invokeRepeatingIfNecessary(VM vm,
                                          RepeatableRunnable task)
```
  - invokeInEveryVMRepeatingIfNecessary
```
protected void invokeInEveryVMRepeatingIfNecessary(RepeatableRunnable work)
```
    Invokes a SerializableRunnable in every VM that DUnit knows about. If work.run() throws an assertion failure, its execution is repeated, until no assertion failure occurs or repeatTimeout milliseconds have passed.
    
    See Also:
    
    VM.invoke(Runnable)
  - getVMCount
```
protected static int getVMCount()
```
    Return the total number of VMs on all hosts
  - dumpStack
```
public static void dumpStack()
```
    print a stack dump for this vm
    
    Since:
    
    5.0
  - dumpStack
```
public static void dumpStack(VM vm)
```
    print a stack dump for the given vm
    
    Since:
    
    5.0
  - dumpStack
```
public static void dumpStack(Host host)
```
    print stack dumps for all vms on the given host
    
    Since:
    
    5.0
  - dumpAllStacks
```
public static void dumpAllStacks()
```
    print stack dumps for all vms
    
    Since:
    
    5.0
  - noteTiming
```
public static String noteTiming(long operations,
                                String operationUnit,
                                long beginTime,
                                long endTime,
                                String timeUnit)
```
  - createLogWriter
```
protected static com.gemstone.gemfire.LogWriter createLogWriter(Properties config)
```
    Creates a new LogWriter and adds it to the config properties. The config can then be used to connect to DistributedSystem, thus providing early access to the LogWriter before connecting. This call does not connect to the DistributedSystem. It simply creates and returns the LogWriter that will eventually be used by the DistributedSystem that connects using config.
    
    Parameters:
    
    config - the DistributedSystem config properties to add LogWriter to
    
    Returns:
    
    early access to the DistributedSystem LogWriter
  - addHydraProperties
```
protected static void addHydraProperties(Properties config)
```
    Fetches the GemFireDescription for this test and adds its DistributedSystem properties to the provided props parameter.
    
    Parameters:
    
    config - the properties to add hydra's test properties to
  - getTestClass
```
protected Class getTestClass()
```
  - getDUnitLogLevel
```
public static String getDUnitLogLevel()
```
    This finds the log level configured for the test run. It should be used when creating a new distributed system if you want to specify a log level.
    
    Returns:
    
    the dunit log-level setting
  - getAllDistributedSystemProperties
```
public final Properties getAllDistributedSystemProperties(Properties props)
```
  - setSystem
```
public void setSystem(Properties props,
                      com.gemstone.gemfire.distributed.DistributedSystem ds)
```
  - getSystem
```
public com.gemstone.gemfire.distributed.internal.InternalDistributedSystem getSystem(Properties props)
```
    Returns this VM's connection to the distributed system. If necessary, the connection will be lazily created using the given Properties. Note that this method uses hydra's configuration to determine the location of log files, etc.
    
    Since:
    
    3.0
    
    See Also:
    
    DistributedConnectionMgr.connect(java.lang.String)
  - crashDistributedSystem
```
public boolean crashDistributedSystem(VM vm)
```
    Crash the cache in the given VM in such a way that it immediately stops communicating with peers. This forces the VM's membership manager to throw a ForcedDisconnectException by forcibly terminating the JGroups protocol stack with a fake EXIT event.
    NOTE: if you use this method be sure that you clean up the VM before the end of your test with disconnectFromDS() or disconnectAllFromDS().
  - crashDistributedSystem
```
public void crashDistributedSystem(com.gemstone.gemfire.distributed.DistributedSystem msys)
```
    Crash the cache in the given VM in such a way that it immediately stops communicating with peers. This forces the VM's membership manager to throw a ForcedDisconnectException by forcibly terminating the JGroups protocol stack with a fake EXIT event.
    NOTE: if you use this method be sure that you clean up the VM before the end of your test with disconnectFromDS() or disconnectAllFromDS().
  - getSystem
```
public final com.gemstone.gemfire.distributed.internal.InternalDistributedSystem getSystem()
```
    Returns this VM's connection to the distributed system. If necessary, the connection will be lazily created using the Properties returned by getDistributedSystemProperties().
    
    Since:
    
    3.0
    
    See Also:
    
    getSystem(Properties)
  - getLonerSystem
```
public final com.gemstone.gemfire.distributed.internal.InternalDistributedSystem getLonerSystem()
```
    Returns a loner distributed system that isn't connected to other vms
    
    Since:
    
    6.5
  - getMcastSystem
```
public final com.gemstone.gemfire.distributed.internal.InternalDistributedSystem getMcastSystem()
```
    Returns an mcast distributed system that is connected to other vms using a random mcast port.
  - getMcastSystem
```
public final com.gemstone.gemfire.distributed.internal.InternalDistributedSystem getMcastSystem(int jgroupsPort)
```
    Returns an mcast distributed system that is connected to other vms using the given mcast port.
  - isConnectedToDS
```
public final boolean isConnectedToDS()
```
    Returns whether or this VM is connected to a DistributedSystem.
  - getDistributedSystemProperties
```
public Properties getDistributedSystemProperties()
```
    Returns a Properties object used to configure a connection to a DistributedSystem. Unless overridden, this method will return an empty Properties object.
    
    Since:
    
    3.0
  - setUp
```
public void setUp()
           throws Exception
```
    Sets up the test (noop).
    
    Overrides:
    
    setUp in class junit.framework.TestCase
    
    Throws:
    
    Exception
  - perVMSetUp
```
public static void perVMSetUp(String name,
                              String defaultDiskStoreName)
```
  - setTestName
```
public static void setTestName(String name)
```
  - getTestName
```
public static String getTestName()
```
  - tearDown
```
public final void tearDown()
                    throws Exception
```
    For logPerTest to work, we have to disconnect from the DS, but all subclasses do not call super.tearDown(). To prevent this scenario this method has been declared final. Subclasses must now override tearDown2() instead.
    
    Overrides:
    
    tearDown in class junit.framework.TestCase
    
    Throws:
    
    Exception
  - realTearDown
```
protected void realTearDown()
                     throws Exception
```
    Throws:
    
    Exception
  - tearDown2
```
public void tearDown2()
               throws Exception
```
    Tears down the test. This method is called by the final tearDown() method, and should be over ridden in its place.
    
    Throws:
    
    Exception
  - cleanupAllVms
```
public static void cleanupAllVms()
```
  - unregisterAllDataSerializersFromAllVms
```
public static void unregisterAllDataSerializersFromAllVms()
```
  - unregisterInstantiatorsInThisVM
```
public static void unregisterInstantiatorsInThisVM()
```
  - unregisterDataSerializerInThisVM
```
public static void unregisterDataSerializerInThisVM()
```
  - disconnectAllFromDS
```
protected static void disconnectAllFromDS()
```
  - disconnectFromDS
```
public static void disconnectFromDS()
```
    Disconnects this VM from the distributed system
  - getServerHostName
```
public static String getServerHostName(Host host)
```
    get the host name to use for a server cache in client/server dunit testing
    
    Parameters:
    
    host -
    
    Returns:
    
    the host name
  - getIPLiteral
```
public static String getIPLiteral()
```
    get the IP literal name for the current host, use this instead of "localhost" to avoid IPv6 name resolution bugs in the JDK/machine config.
    
    Returns:
    
    an ip literal, this method honors java.net.preferIPvAddresses
  - getDUnitLocatorPort
```
public static int getDUnitLocatorPort()
```
    Get the port that the standard dunit locator is listening on.
    
    Returns:
  - getDUnitLocatorAddress
```
public static String getDUnitLocatorAddress()
```
    Get the address that the standard dunit locator is listening on.
    
    Returns:
  - getDUnitLocatorString
```
public static String getDUnitLocatorString()
```
  - getUniqueName
```
public String getUniqueName()
```
    Returns a unique name for this test method. It is based on the name of the class as well as the name of the method.
  - getLogWriter
```
public static com.gemstone.gemfire.LogWriter getLogWriter()
```
    Returns a LogWriter for logging information
  - fail
```
public static void fail(String message,
                        Throwable ex)
```
    Helper method that causes this test to fail because of the given exception.
  - pause
```
protected void pause()
```
    pause for a default interval
  - staticPause
```
public static final void staticPause(int ms)
```
    Use of this function indicates a place in the tests tree where t he use of Thread.sleep() is highly questionable.
    Some places in the system, especially those that test expirations and other timeouts, have a very good reason to call Thread.sleep(long). The other places are marked by the use of this method.
    
    Parameters:
    
    ms -
  - pause
```
public static final void pause(int ms)
```
    pause for specified ms interval Make sure system clock has advanced by the specified number of millis before returning.
  - waitForCriterion
```
public static void waitForCriterion(DistributedTestCase.WaitCriterion ev,
                                    long ms,
                                    long interval,
                                    boolean throwOnTimeout)
```
    Wait until given criterion is met
    
    Parameters:
    
    ev - criterion to wait on
    
    ms - total time to wait, in milliseconds
    
    interval - pause interval between waits
    
    throwOnTimeout - if false, don't generate an error
  - waitMutex
```
public static void waitMutex(DistributedTestCase.WaitCriterion ev,
                             Object mutex,
                             long ms,
                             long interval,
                             boolean throwOnTimeout)
```
    Wait on a mutex. This is done in a loop in order to address the "spurious wakeup" "feature" in Java.
    
    Parameters:
    
    ev - condition to test
    
    mutex - object to lock and wait on
    
    ms - total amount of time to wait
    
    interval - interval to pause for the wait
    
    throwOnTimeout - if false, no error is thrown.
  - join
```
public static void join(Thread t,
                        long ms,
                        com.gemstone.gemfire.LogWriter logger)
```
    Wait for a thread to join
    
    Parameters:
    
    t - thread to wait on
    
    ms - maximum time to wait
    
    Throws:
    
    AssertionFailure - if the thread does not terminate
  - dumpStackTrace
```
public static void dumpStackTrace(Thread t,
                                  StackTraceElement[] stack,
                                  com.gemstone.gemfire.LogWriter logger)
```
  - dumpMyThreads
```
public static void dumpMyThreads(com.gemstone.gemfire.LogWriter logger)
```
    Dump all thread stacks
  - setDiskStoreForGateway
```
protected static void setDiskStoreForGateway(com.gemstone.gemfire.cache.Cache cache,
                                             String gatewayId,
                                             com.gemstone.gemfire.cache.util.GatewayQueueAttributes queueAttributes)
```
  - addExpectedException
```
public static DistributedTestCase.ExpectedException addExpectedException(String exception)
```
    Log in all VMs, in both the Hydra logger and the GemFire logger the expected exception string to prevent grep logs from complaining. The expected string is used by the Perl grepLog.pl utility and so can contain regular expression characters.
    
    Parameters:
    
    exception - the exception string to expect
    
    Returns:
    
    an ExpectedException instance for removal
    
    Since:
    
    5.7bugfix
  - addExpectedException
```
public static DistributedTestCase.ExpectedException addExpectedException(String exception,
                                                                         VM v)
```
    Log in all VMs, in both the Hydra logger and the GemFire logger the expected exception string to prevent grep logs from complaining. The expected string is used by the Perl grepLog.pl utility and so can contain regular expression characters.
    
    Parameters:
    
    exception - the exception string to expect
    
    v - the VM on which to log the expected exception or null for all VMs
    
    Returns:
    
    an ExpectedException instance for removal purposes
    
    Since:
    
    5.7bugfix
  - incBBFlag
```
public static void incBBFlag(String name)
```
  - clearBBFlag
```
public static void clearBBFlag(String name)
```
  - checkBBFlag
```
public static void checkBBFlag(String name,
                               int expectedValue)
                        throws com.gemstone.gemfire.cache.CacheException
```
    Throws:
    
    com.gemstone.gemfire.cache.CacheException
  - waitForBBFlag
```
public static void waitForBBFlag(String name,
                                 int expectedValue,
                                 long timeout)
                          throws com.gemstone.gemfire.cache.TimeoutException
```
    Throws:
    
    com.gemstone.gemfire.cache.TimeoutException

Class DistributedTestCase

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class junit.framework.TestCase

Methods inherited from class java.lang.Object

Field Detail

system

testName

reconnect

logPerTest

Constructor Detail

DistributedTestCase

Method Detail

attachDebugger

invokeInEveryVM

invokeInLocator

invokeInEveryVM

invokeInEveryVM

invokeInEveryVM

getRepeatTimeoutMs

invokeRepeatingIfNecessary

invokeInEveryVMRepeatingIfNecessary

getVMCount

dumpStack

dumpStack

dumpStack

dumpAllStacks

noteTiming

createLogWriter

addHydraProperties

getTestClass

getDUnitLogLevel

getAllDistributedSystemProperties

setSystem

getSystem

crashDistributedSystem

crashDistributedSystem

getSystem

getLonerSystem

getMcastSystem

getMcastSystem

isConnectedToDS

getDistributedSystemProperties

setUp

perVMSetUp

setTestName

getTestName

tearDown

realTearDown

tearDown2

cleanupAllVms

unregisterAllDataSerializersFromAllVms

unregisterInstantiatorsInThisVM

unregisterDataSerializerInThisVM

disconnectAllFromDS

disconnectFromDS

getServerHostName

getIPLiteral

getDUnitLocatorPort

getDUnitLocatorAddress

getDUnitLocatorString

getUniqueName

getLogWriter

fail

pause

staticPause

pause

waitForCriterion

waitMutex

join

dumpStackTrace

dumpMyThreads

setDiskStoreForGateway

addExpectedException

addExpectedException

incBBFlag

clearBBFlag

checkBBFlag