com.gemstone.gemfire.distributed

Class LocatorTest

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

dunit.DistributedTestCase

com.gemstone.gemfire.distributed.LocatorTest

All Implemented Interfaces:

java.io.Serializable, junit.framework.Test

public class LocatorTest
extends DistributedTestCase

Tests the ability of the Locator API to start and stop locators running in remote VMs.

Since:

4.0

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class dunit.DistributedTestCase

DistributedTestCase.ExpectedException, DistributedTestCase.WaitCriterion, DistributedTestCase.WaitCriterion2

Field Summary

Fields inherited from class dunit.DistributedTestCase

logPerTest, reconnect, system, testName

Constructor Summary

Constructors

Constructor and Description
LocatorTest(java.lang.String name) Creates a new LocatorTest

Method Summary

Modifier and Type	Method and Description
static boolean	anyNormalFDDisconnects()
void	DISABLED_BUG51468testBug30341() Bug 30341 concerns race conditions in JGroups that allow two locators to start up in a split-brain configuration.
static com.gemstone.gemfire.distributed.DistributedMember	getDistributedMember(java.util.Properties props) return the distributed member id for the ds on this vm
static com.gemstone.gemfire.distributed.DistributedMember	getLeadMember() find the lead member and return its id
static com.gemstone.gemfire.distributed.DistributedMember	getLocatorDistributedMember() find a running locator and return its distributed member id
static boolean	isSystemConnected()
protected void	nukeJChannel(com.gemstone.gemfire.distributed.DistributedSystem sys)
static void	resetRefreshWait() remove shortened locator refresh rate
static void	setShortRefreshWait() set a short locator refresh rate
void	setUp() Sets up the test (noop).
void	tearDown2() Tears down the test.
void	testCollocatedLocatorWithSecurity() GemFireXD uses a colocated locator in a dm-type=normal VM.
void	testConnectToOwnLocator() Tests that a VM can connect to a locator that is hosted in its own VM.
void	testForceDisconnectAndPeerShutdownCause() test lead member failure and normal coordinator shutdown with network partition detection enabled.
void	testHostingMultipleLocators() Tests that a single VM can NOT host multiple locators
void	testLeadAndCoordFailure() test lead member and coordinator failure with network partition detection enabled.
void	testLeadFailureAndCoordShutdown() test lead member failure and normal coordinator shutdown with network partition detection enabled.
void	testLeadMemberSelection() test lead member selection
void	testLeadShutdownAndCoordFailure() test lead member shutdown and coordinator crashing with network partition detection enabled.
void	testLocatorForcesDetection() Tests that a VM cannot connect if the locator has a different enable-network-partition-detection setting
void	testMultipleLocators() Tests starting multiple locators in multiple VMs.
void	testMultipleMcastLocators() Tests starting multiple locators in multiple VMs.
void	testNoLocator() Tests that attempting to connect to a distributed system in which no locator is defined throws an exception.
void	testOneLocator() Tests starting one locator in a remote VM and having multiple members of the distributed system join it.
void	testOneStoppedLocator() Tests starting one locator in a remote VM and having multiple members of the distributed system join it.
void	testQuorumLossNotification() this is very similar to testLeadAndCoordFailure but forced-disconnects aren't generated.
void	testRestartLocator() Tests starting, stopping, and restarting a locator.
static boolean	waitUntilFDConnected(long timeout)

Methods inherited from class dunit.DistributedTestCase

addExpectedException, addExpectedException, addHydraProperties, attachDebugger, checkBBFlag, cleanupAllVms, clearBBFlag, crashDistributedSystem, crashDistributedSystem, createLogWriter, disconnectAllFromDS, disconnectFromDS, dumpAllStacks, dumpMyThreads, dumpStack, dumpStack, dumpStack, dumpStackTrace, fail, getAllDistributedSystemProperties, getDistributedSystemProperties, getDUnitLocatorAddress, getDUnitLocatorPort, getDUnitLocatorString, getDUnitLogLevel, getIPLiteral, getLogWriter, getLonerSystem, getMcastSystem, getMcastSystem, getRepeatTimeoutMs, getServerHostName, getSystem, getSystem, getTestClass, getTestName, getUniqueName, getVMCount, incBBFlag, invokeInEveryVM, invokeInEveryVM, invokeInEveryVM, invokeInEveryVM, invokeInEveryVMRepeatingIfNecessary, invokeInLocator, invokeRepeatingIfNecessary, isConnectedToDS, join, noteTiming, pause, pause, perVMSetUp, realTearDown, setDiskStoreForGateway, setSystem, setTestName, staticPause, tearDown, unregisterAllDataSerializersFromAllVms, unregisterDataSerializerInThisVM, unregisterInstantiatorsInThisVM, waitForBBFlag, waitForCriterion, waitMutex

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

Constructor Detail

LocatorTest

public LocatorTest(java.lang.String name)

Creates a new LocatorTest

Method Detail

setUp

public void setUp()

Description copied from class: DistributedTestCase

Sets up the test (noop).

Overrides:

setUp in class DistributedTestCase

tearDown2

public void tearDown2()

Description copied from class: DistributedTestCase

Tears down the test. This method is called by the final DistributedTestCase.tearDown() method, and should be over ridden in its place.

Overrides:

tearDown2 in class DistributedTestCase

testCollocatedLocatorWithSecurity

public void testCollocatedLocatorWithSecurity()
                                       throws java.lang.Exception

GemFireXD uses a colocated locator in a dm-type=normal VM. This tests that the locator can resume control as coordinator after all locators have been shut down and one is restarted. It's necessary to have a lock service start so elder failover is forced to happen. Prior to fixing how this worked it hung with the restarted locator trying to become elder again because it put its address at the beginning of the new view it sent out.

Throws:

java.lang.Exception

DISABLED_BUG51468testBug30341

public void DISABLED_BUG51468testBug30341()
                                   throws java.lang.Exception

Bug 30341 concerns race conditions in JGroups that allow two locators to start up in a split-brain configuration. To work around this we have always told customers that they need to stagger the starting of locators. This test configures two locators to start up simultaneously and shows that they will refuse to boot if they do not find one another and form a single distributed system.

Throws:

java.lang.Exception

testLeadMemberSelection

public void testLeadMemberSelection()
                             throws java.lang.Exception

test lead member selection

Throws:

java.lang.Exception

testLeadAndCoordFailure

public void testLeadAndCoordFailure()
                             throws java.lang.Exception

test lead member and coordinator failure with network partition detection enabled. It would be nice for this test to have more than two "server" vms, to demonstrate that they all exit when the leader and potential- coordinator both disappear in the loss-correlation-window, but there are only four vms available for dunit testing.

So, we start two locators with admin distributed systems, then start two regular distributed members.

We kill the second locator (which is not the view coordinator) and then kill the non-lead member. That should be okay - the lead and remaining locator continue to run.

We then kill the lead member and demonstrate that the original locator (which is now the sole remaining member) shuts itself down.

Throws:

java.lang.Exception

testQuorumLossNotification

public void testQuorumLossNotification()
                                throws java.lang.Exception

this is very similar to testLeadAndCoordFailure but forced-disconnects aren't generated. Network partition detection is not enabled and we merely look to see if surviving members notify listeners that quorum was lost.

we start two locators with admin distributed systems, then start two regular distributed members.

We kill the second locator (which is not the view coordinator) and then kill the non-lead member. That should be okay - the lead and remaining locator continue to run.

We then kill the lead member and demonstrate that the original locator (which is now the sole remaining member) notifies listeners.

Throws:

java.lang.Exception

testLeadFailureAndCoordShutdown

public void testLeadFailureAndCoordShutdown()
                                     throws java.lang.Exception

test lead member failure and normal coordinator shutdown with network partition detection enabled.

Start two locators with admin distributed systems, then start two regular distributed members.

We kill the lead member and demonstrate that the other members continue to operate normally.

We then shut down the group coordinator and observe the second locator pick up the job and the remaining member continues to operate normally.

Throws:

java.lang.Exception

testForceDisconnectAndPeerShutdownCause

public void testForceDisconnectAndPeerShutdownCause()
                                             throws java.lang.Exception

test lead member failure and normal coordinator shutdown with network partition detection enabled.

Start one locators with admin distributed systems, then start two regular distributed members.

We kill the lead member and demonstrate that the other members continue to operate normally.

We then shut down the group coordinator and observe the second locator pick up the job and the remaining member continues to operate normally.

Throws:

java.lang.Exception

testLeadShutdownAndCoordFailure

public void testLeadShutdownAndCoordFailure()
                                     throws java.lang.Exception

test lead member shutdown and coordinator crashing with network partition detection enabled.

Start two locators with admin distributed systems, then start two regular distributed members.

We kill the coordinator and shut down the lead member and observe the second locator pick up the job and the remaining member continue to operate normally.

Throws:

java.lang.Exception

testNoLocator

public void testNoLocator()

Tests that attempting to connect to a distributed system in which no locator is defined throws an exception.

testOneLocator

public void testOneLocator()
                    throws java.lang.Exception

Tests starting one locator in a remote VM and having multiple members of the distributed system join it. This ensures that members start up okay, and that handling of a stopped locator is correct.

Throws:

java.lang.Exception

testOneStoppedLocator

public void testOneStoppedLocator()
                           throws java.lang.Exception

Tests starting one locator in a remote VM and having multiple members of the distributed system join it. This ensures that members start up okay, and that handling of a stopped locator is correct. It then restarts the locator to demonstrate that it can connect to and function as the group coordinator

Throws:

java.lang.Exception

setShortRefreshWait

public static void setShortRefreshWait()

set a short locator refresh rate

resetRefreshWait

public static void resetRefreshWait()

remove shortened locator refresh rate

isSystemConnected

public static boolean isSystemConnected()

anyNormalFDDisconnects

public static boolean anyNormalFDDisconnects()

waitUntilFDConnected

public static boolean waitUntilFDConnected(long timeout)

testMultipleLocators

public void testMultipleLocators()
                          throws java.lang.Exception

Tests starting multiple locators in multiple VMs.

Throws:

java.lang.Exception

testMultipleMcastLocators

public void testMultipleMcastLocators()
                               throws java.lang.Exception

Tests starting multiple locators in multiple VMs.

Throws:

java.lang.Exception

testConnectToOwnLocator

public void testConnectToOwnLocator()
                             throws java.lang.Exception

Tests that a VM can connect to a locator that is hosted in its own VM.

Throws:

java.lang.Exception

testLocatorForcesDetection

public void testLocatorForcesDetection()
                                throws java.lang.Exception

Tests that a VM cannot connect if the locator has a different enable-network-partition-detection setting

Throws:

java.lang.Exception

testHostingMultipleLocators

public void testHostingMultipleLocators()
                                 throws java.lang.Exception

Tests that a single VM can NOT host multiple locators

Throws:

java.lang.Exception

testRestartLocator

public void testRestartLocator()
                        throws java.lang.Exception

Tests starting, stopping, and restarting a locator. See bug 32856.

Throws:

java.lang.Exception

Since:

4.1

getDistributedMember

public static com.gemstone.gemfire.distributed.DistributedMember getDistributedMember(java.util.Properties props)

return the distributed member id for the ds on this vm

getLocatorDistributedMember

public static com.gemstone.gemfire.distributed.DistributedMember getLocatorDistributedMember()

find a running locator and return its distributed member id

getLeadMember

public static com.gemstone.gemfire.distributed.DistributedMember getLeadMember()

find the lead member and return its id

nukeJChannel

protected void nukeJChannel(com.gemstone.gemfire.distributed.DistributedSystem sys)