diskRecovery

Class RecoveryTestVersionHelper

java.lang.Object

diskRecovery.RecoveryTestVersionHelper

public class RecoveryTestVersionHelper
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RecoveryTestVersionHelper.KeySnapshotFilter Key SnapshotFilter only accepts original entries (created before snapshot written) based on the key (FilterObject_XXX vs.
static class	RecoveryTestVersionHelper.ValueSnapshotFilter Value SnapshotFilter only accepts original entries (created before snapshot written) based on the value (value should NOT start with this string "object to be filtered").
static class	RecoveryTestVersionHelper.ValueTypeSnapshotFilter Value Type SnapshotFilter only accepts original entries (created before snapshot written) based on the value type (ValueHolders are accepted, String values are not).

Constructor Summary

Constructors

Constructor and Description
RecoveryTestVersionHelper()

Method Summary

Modifier and Type	Method and Description
static String	createDiskStore(com.gemstone.gemfire.cache.RegionAttributes attr) Create the DiskStore if the RegionAttributes specifies it.
static void	createXmlFile() Create an xml file for the current cache and all its regions.
static void	doOperationsHA(RecoveryTest testInstance) Task to do random operations that expect exceptions from shutDownAllMembers
static void	doOperationsShutDownAll(RecoveryTest testInstance) Task to do random operations that expect exceptions from shutDownAllMembers
static void	forceRecovery(boolean doValidation) Forces recovery by revoking the members the system is waiting for.
static BaseValueHolder	getVersionedValueHolder(String valueClassName, String key, RandomValues randomValues)
static void	handleOpsException(Exception e)
static void	handleOpsExceptionDuringShutDownAll(Exception e) During a shutDownAll we are disconnected from the DS and exceptions can occur.
static void	HydraTask_initializeExpectException() Creates and initializes a server or peer.
protected static void	importAndVerify(RecoveryTest testInstance) One thread imports ...
static void	initPdxClassLoader()
static void	initPRObserver() Initialize the PRObserver
static void	installPersistenceObserver() Install a PersistenceObserver to help tests create a "tie" on disk recovery.
static void	installPRObserver() Install the PRObserver
static boolean	instanceOfPdxInstance(Object value)
static void	logDiskStore(com.gemstone.gemfire.cache.Region aRegion, StringBuffer aStr) Appends to a StringBuffer logging that describes a DiskSTore for the given Region.
protected static void	performBackup() Performs a backup.
static void	removeDiskFiles() Remove disk files in disk dirs corresponding to this vm's vmID.
static com.gemstone.gemfire.cache.AttributesFactory	setDiskStoreIfNeeded(String regionConfigName) Set a random DiskStore for the region defined with regionConfigName if it is persistent or has eviction with overflow to disk.
static void	setRandomDiskStore(com.gemstone.gemfire.cache.RegionAttributes baseAttr, com.gemstone.gemfire.cache.AttributesFactory attrFac, List<String> diskStoreNames, GsRandom rand) Choose a random DiskStore and set it in the attributes factory.
protected static void	snapshotResponder(RecoveryTest testInstance) Do operations and pause when directed by the snapshotController Also, writes the snapshot to the blackboard and exports snapshot to disk
static BaseValueHolder	toValueHolder(Object value)
protected static void	verifyWaiting(ClientVmInfo expectedWaitingForMember, List<ClientVmInfo> membersWaiting) Verify that the system is waiting for member(s) to come up before recovering.
static boolean	withPersistence(com.gemstone.gemfire.cache.Region aRegion) Return whether the given region has persistence

Methods inherited from class java.lang.Object

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

Constructor Detail

RecoveryTestVersionHelper

public RecoveryTestVersionHelper()

Method Detail

setRandomDiskStore

public static void setRandomDiskStore(com.gemstone.gemfire.cache.RegionAttributes baseAttr,
                                      com.gemstone.gemfire.cache.AttributesFactory attrFac,
                                      List<String> diskStoreNames,
                                      GsRandom rand)

Choose a random DiskStore and set it in the attributes factory.

Parameters:

baseAttr - The region attributes we start with (without a DiskStore set)

attrFac - The attributes factory to set the DiskStore in.

diskStoreNames - A List of potential DiskStore names to choose from.

rand - The random number generator used while creating regions and attributes.

createDiskStore

public static String createDiskStore(com.gemstone.gemfire.cache.RegionAttributes attr)

Create the DiskStore if the RegionAttributes specifies it.

Parameters:

attr - The RegionAttributes that could specify a DiskStore.

Returns:

A String description of the DiskStore, useful for logging.

logDiskStore

public static void logDiskStore(com.gemstone.gemfire.cache.Region aRegion,
                                StringBuffer aStr)

Appends to a StringBuffer logging that describes a DiskSTore for the given Region.

Parameters:

aRegion - The Region possibly containing a DiskStore.

aStr - The StringBuffer to append to.

installPersistenceObserver

public static void installPersistenceObserver()

Install a PersistenceObserver to help tests create a "tie" on disk recovery.

HydraTask_initializeExpectException

public static void HydraTask_initializeExpectException()
                                                throws Throwable

Creates and initializes a server or peer.

Throws:

Throwable

verifyWaiting

protected static void verifyWaiting(ClientVmInfo expectedWaitingForMember,
                                    List<ClientVmInfo> membersWaiting)

Verify that the system is waiting for member(s) to come up before recovering.

Parameters:

expectedWaitingForMember - This specifies the vmID of the member the system should be waiting for.

membersWaiting - This is a List of the members that should be waiting.

forceRecovery

public static void forceRecovery(boolean doValidation)

Forces recovery by revoking the members the system is waiting for. It is the responsibility of the caller to know that the correct members are being waited for since this will revoke all waiting members.

Parameters:

doValidation - If true, then validate the missing disk stores (used for serial tests or tests that are in a silent phase), if false then don't do validation (used for concurrent tests).

withPersistence

public static boolean withPersistence(com.gemstone.gemfire.cache.Region aRegion)

Return whether the given region has persistence

Parameters:

aRegion - The Region to check for persistence.

Returns:

True if the region has persistence, false otherwise.

removeDiskFiles

public static void removeDiskFiles()

Remove disk files in disk dirs corresponding to this vm's vmID.

doOperationsShutDownAll

public static void doOperationsShutDownAll(RecoveryTest testInstance)
                                    throws Exception

Task to do random operations that expect exceptions from shutDownAllMembers

Parameters:

testInstance - The RecoveryTest instance.

Throws:

Exception

doOperationsHA

public static void doOperationsHA(RecoveryTest testInstance)
                           throws Exception

Task to do random operations that expect exceptions from shutDownAllMembers

Parameters:

testInstance - The RecoveryTest instance.

Throws:

Exception

handleOpsExceptionDuringShutDownAll

public static void handleOpsExceptionDuringShutDownAll(Exception e)

During a shutDownAll we are disconnected from the DS and exceptions can occur. This method is called when we know we are undergoing a shutdown all and allows certain exceptions

Parameters:

e - The exception that occurred during shutDownAll

installPRObserver

public static void installPRObserver()

Install the PRObserver

initPRObserver

public static void initPRObserver()

Initialize the PRObserver

setDiskStoreIfNeeded

public static com.gemstone.gemfire.cache.AttributesFactory setDiskStoreIfNeeded(String regionConfigName)

Set a random DiskStore for the region defined with regionConfigName if it is persistent or has eviction with overflow to disk.

Parameters:

regionConfigName - A hydra region config name. return factory The attributes factory for the regionConfigName with possibly a DiskStore.

handleOpsException

public static void handleOpsException(Exception e)

createXmlFile

public static void createXmlFile()

Create an xml file for the current cache and all its regions.

initPdxClassLoader

public static void initPdxClassLoader()

getVersionedValueHolder

public static BaseValueHolder getVersionedValueHolder(String valueClassName,
                                                      String key,
                                                      RandomValues randomValues)

Parameters:

valueClassName -

key -

randomValues -

Returns:

instanceOfPdxInstance

public static boolean instanceOfPdxInstance(Object value)

Parameters:

value -

Returns:

toValueHolder

public static BaseValueHolder toValueHolder(Object value)

Parameters:

value -

Returns:

snapshotResponder

protected static void snapshotResponder(RecoveryTest testInstance)
                                 throws Exception

Do operations and pause when directed by the snapshotController Also, writes the snapshot to the blackboard and exports snapshot to disk

Throws:

Exception

importAndVerify

protected static void importAndVerify(RecoveryTest testInstance)

One thread imports ... everyone validates against blackboard snapshot

performBackup

protected static void performBackup()

Performs a backup.