SustainabilityTest (GemFire XD Java API Documentation)

java.lang.Object
- sustainability.SustainabilityTest

public class SustainabilityTest
extends java.lang.Object

Constructor Summary

Constructors
Constructor and Description

SustainabilityTest()

Constructors
Constructor and Description
`SustainabilityTest()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`checkGetInitialImageStats()` Checks the integrity of all the regions by making sure there are seven regions defined and all the regions have 20000 key-value pair.
`static void`	`createCacheAndRegionsWithBackUp()` Creates the cache from the xml file specified by xmlFileName.
`static void`	`createCacheAndRegionsWithRoleLoss()` Creates a cache from an xml file specified by xmlFileName expected to lose a required role.
`static void`	`createCacheRequiresABFromXML()` Creates a cache from a cache xml file specified by xmlFileNameRequireAB variable.
`static void`	`createMultiRegionRequireRoles()` Creats the cache from the xml file specified by xmlFileName parameter.
`static void`	`createRolePlayerAVm()` Creats a vm playing a role "rolePlayerA".
`static void`	`createRolePlayerBVm()` Creats a vm playing a role "rolePlayerB".
`static void`	`createRolePlayerCVm()` Creats a vm playing a role "rolePlayerC".
`static void`	`createRolePlayerDVm()` Creats a vm playing a role "rolePlayerD".
`static void`	`createRolePlayerEVm()` Creats a vm playing a role "rolePlayerE".
`static void`	`createRolePlayerFVm()` Creats a vm playing a role "rolePlayerF".
`static void`	`createRolePlayerGVm()` Creats a vm playing a role "rolePlayerG".
`static void`	`createRolePlayerVm()` Creates a cache playing the role of "rolePlayer" defined by hydra.GemFirePrms-roles property defined in reconnectRoleLossBackUP.conf.
`static void`	`createSelfRolePlayingVm()` Create a cache which playes the role of "rolePlayerA" which is required by the region created in this cache.
`static void`	`createSingleRegionRequiresRoleAB()`
`static void`	`doSomeThing()` Keeps the vm alive for hydra.
`static void`	`generateABRegionRequiredXml()` Generates the xml file used when the vm reconnects and throws exception when not able to generate xml file.
`static void`	`generateXml()` Generates an xml file with a region and required role.
`static void`	`generateXml(com.gemstone.gemfire.cache.Cache cache)`
`static void`	`generateXmlWithMultiRequiredRoles()` Generates an xml file with mutiple regions with required roles.
`static void`	`printRegions()` Prints all the root regions in the cache.
`static void`	`putKeysValues(com.gemstone.gemfire.cache.Region theRegion)` Puts 20000 keys value for the region passed as parameter to the method.
`static void`	`putKeysValuesRegionA()` Puts multiple keys value pair in RegionA.
`static void`	`putKeysValuesRegionB()` Puts multiple keys value pair in RegionB.
`static void`	`putKeysValuesRegionC()` Puts multiple keys value pair in RegionC.
`static void`	`putKeysValuesRegionD()` Puts multiple keys value pair in RegionD.
`static void`	`putKeysValuesRegionE()` Puts multiple keys value pair in RegionE.
`static void`	`putKeysValuesRegionF()` Puts multiple keys value pair in RegionF.
`static void`	`putKeysValuesRegionG()` Puts multiple keys value pair in RegionG.
`static void`	`putRegionA()` Puts some key value pair in regionA.
`static void`	`putRegionB()` Puts some keys value in regionB.
`static void`	`startClient()`
`static void`	`startClient(java.lang.String theClient)`
`static void`	`stopAndRestartRandomRolePlayingClients()` Stops and restarts a random client from a vector of clients configured in the conf file by "roles.RolesPrms-clientsToStop" property.
`static void`	`stopClient()` Stops a client specified by the roles.RolesPrms-clientsToStop parameter.
`static void`	`stopClient(java.lang.String theClient)` Stops a particular client specified by the parameter.
`static void`	`stopOtherClients()` Stops and restarts a client vm.
`static void`	`validateCacheCreation()` Validates the cache creation and regions after it reconnects properly to the distributed system.
`static void`	`validateSelfRolePlayerClient()` Validates the integrity of the region defined in the cache playing the role required by the region.

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

- Constructor Detail
  - SustainabilityTest
```
public SustainabilityTest()
```
- Method Detail
  - generateXml
```
public static void generateXml()
                        throws com.gemstone.gemfire.cache.TimeoutException,
                               com.gemstone.gemfire.cache.CacheWriterException,
                               com.gemstone.gemfire.cache.CacheExistsException,
                               com.gemstone.gemfire.cache.RegionExistsException,
                               java.io.IOException
```
    Generates an xml file with a region and required role.
    
    Throws:
    
    com.gemstone.gemfire.cache.TimeoutException
    
    com.gemstone.gemfire.cache.CacheWriterException
    
    com.gemstone.gemfire.cache.CacheExistsException
    
    com.gemstone.gemfire.cache.RegionExistsException
    
    java.io.IOException
  - generateXmlWithMultiRequiredRoles
```
public static void generateXmlWithMultiRequiredRoles()
                                              throws java.lang.Exception
```
    Generates an xml file with mutiple regions with required roles. Every region defined has a required role played by some other vm in the system. When the xml is genrate all the role playin vms required should be up and running otherwise will get a CacheClosedException,
    
    Throws:
    
    Exception.
    
    java.lang.Exception
  - generateXml
```
public static void generateXml(com.gemstone.gemfire.cache.Cache cache)
                        throws java.lang.Exception
```
    Throws:
    
    java.lang.Exception
  - generateABRegionRequiredXml
```
public static void generateABRegionRequiredXml()
                                        throws java.lang.Exception
```
    Generates the xml file used when the vm reconnects and throws exception when not able to generate xml file.
    
    Throws:
    
    java.lang.Exception
  - createRolePlayerVm
```
public static void createRolePlayerVm()
                               throws com.gemstone.gemfire.cache.TimeoutException,
                                      com.gemstone.gemfire.cache.CacheWriterException,
                                      com.gemstone.gemfire.cache.CacheExistsException,
                                      com.gemstone.gemfire.cache.RegionExistsException
```
    Creates a cache playing the role of "rolePlayer" defined by hydra.GemFirePrms-roles property defined in reconnectRoleLossBackUP.conf.
    
    Throws:
    
    com.gemstone.gemfire.cache.TimeoutException
    
    com.gemstone.gemfire.cache.CacheWriterException
    
    com.gemstone.gemfire.cache.CacheExistsException
    
    com.gemstone.gemfire.cache.RegionExistsException
  - createSingleRegionRequiresRoleAB
```
public static void createSingleRegionRequiresRoleAB()
                                             throws java.lang.Exception
```
    Throws:
    
    java.lang.Exception
  - createSelfRolePlayingVm
```
public static void createSelfRolePlayingVm()
                                    throws java.lang.Exception
```
    Create a cache which playes the role of "rolePlayerA" which is required by the region created in this cache.
    
    Throws:
    
    java.lang.Exception
  - createRolePlayerAVm
```
public static void createRolePlayerAVm()
```
    Creats a vm playing a role "rolePlayerA". The roles parameter is defined in the conf file for the test by specifing hydra.GemFirePrms-roles property for all the vms.
  - createRolePlayerBVm
```
public static void createRolePlayerBVm()
```
    Creats a vm playing a role "rolePlayerB". The roles parameter is defined in the conf file for the test by specifing hydra.GemFirePrms-roles property for all the vms.
  - createRolePlayerCVm
```
public static void createRolePlayerCVm()
```
    Creats a vm playing a role "rolePlayerC". The roles parameter is defined in the conf file for the test by specifing hydra.GemFirePrms-roles property for all the vms.
  - createRolePlayerDVm
```
public static void createRolePlayerDVm()
```
    Creats a vm playing a role "rolePlayerD". The roles parameter is defined in the conf file for the test by specifing hydra.GemFirePrms-roles property for all the vms.
  - createRolePlayerEVm
```
public static void createRolePlayerEVm()
```
    Creats a vm playing a role "rolePlayerE". The roles parameter is defined in the conf file for the test by specifing hydra.GemFirePrms-roles property for all the vms.
  - createRolePlayerFVm
```
public static void createRolePlayerFVm()
```
    Creats a vm playing a role "rolePlayerF". The roles parameter is defined in the conf file for the test by specifing hydra.GemFirePrms-roles property for all the vms.
  - createRolePlayerGVm
```
public static void createRolePlayerGVm()
```
    Creats a vm playing a role "rolePlayerG". The roles parameter is defined in the conf file for the test by specifing hydra.GemFirePrms-roles property for all the vms.
  - createCacheAndRegionsWithRoleLoss
```
public static void createCacheAndRegionsWithRoleLoss()
                                              throws java.lang.Exception
```
    Creates a cache from an xml file specified by xmlFileName expected to lose a required role.
    
    Throws:
    
    java.lang.Exception
  - createCacheAndRegionsWithBackUp
```
public static void createCacheAndRegionsWithBackUp()
                                            throws java.lang.Exception
```
    Creates the cache from the xml file specified by xmlFileName.
    
    Throws:
    
    Exception.
    
    java.lang.Exception
  - createCacheRequiresABFromXML
```
public static void createCacheRequiresABFromXML()
                                         throws java.lang.Exception
```
    Creates a cache from a cache xml file specified by xmlFileNameRequireAB variable. Throws exception when not able to create a cache and tries for more than 5 times due to a role loss. throws Exception
    
    Throws:
    
    java.lang.Exception
  - validateCacheCreation
```
public static void validateCacheCreation()
                                  throws java.lang.Exception
```
    Validates the cache creation and regions after it reconnects properly to the distributed system.
    
    Throws:
    
    java.lang.Exception
  - createMultiRegionRequireRoles
```
public static void createMultiRegionRequireRoles()
```
    Creats the cache from the xml file specified by xmlFileName parameter.
  - validateSelfRolePlayerClient
```
public static void validateSelfRolePlayerClient()
                                         throws java.lang.Exception
```
    Validates the integrity of the region defined in the cache playing the role required by the region.
    
    Throws:
    
    java.lang.Exception
  - checkGetInitialImageStats
```
public static void checkGetInitialImageStats()
                                      throws java.lang.Exception
```
    Checks the integrity of all the regions by making sure there are seven regions defined and all the regions have 20000 key-value pair. If not then is throws an exception with appropriate message.
    
    Throws:
    
    java.lang.Exception
  - putRegionA
```
public static void putRegionA()
                       throws java.lang.Exception
```
    Puts some key value pair in regionA.
    
    Throws:
    
    Exception.
    
    java.lang.Exception
  - putRegionB
```
public static void putRegionB()
                       throws java.lang.Exception
```
    Puts some keys value in regionB.
    
    Throws:
    
    Exception.
    
    java.lang.Exception
  - putKeysValuesRegionA
```
public static void putKeysValuesRegionA()
                                 throws java.lang.Exception
```
    Puts multiple keys value pair in RegionA.
    
    Throws:
    
    java.lang.Exception
  - putKeysValuesRegionB
```
public static void putKeysValuesRegionB()
                                 throws java.lang.Exception
```
    Puts multiple keys value pair in RegionB.
    
    Throws:
    
    java.lang.Exception
  - putKeysValuesRegionC
```
public static void putKeysValuesRegionC()
                                 throws java.lang.Exception
```
    Puts multiple keys value pair in RegionC.
    
    Throws:
    
    java.lang.Exception
  - putKeysValuesRegionD
```
public static void putKeysValuesRegionD()
                                 throws java.lang.Exception
```
    Puts multiple keys value pair in RegionD.
    
    Throws:
    
    java.lang.Exception
  - putKeysValuesRegionE
```
public static void putKeysValuesRegionE()
                                 throws java.lang.Exception
```
    Puts multiple keys value pair in RegionE.
    
    Throws:
    
    java.lang.Exception
  - putKeysValuesRegionF
```
public static void putKeysValuesRegionF()
                                 throws java.lang.Exception
```
    Puts multiple keys value pair in RegionF.
    
    Throws:
    
    java.lang.Exception
  - putKeysValuesRegionG
```
public static void putKeysValuesRegionG()
                                 throws java.lang.Exception
```
    Puts multiple keys value pair in RegionG.
    
    Throws:
    
    java.lang.Exception
  - putKeysValues
```
public static void putKeysValues(com.gemstone.gemfire.cache.Region theRegion)
                          throws java.lang.Exception
```
    Puts 20000 keys value for the region passed as parameter to the method.
    
    Parameters:
    
    region - Region
    
    Throws:
    
    java.lang.Exception
  - stopOtherClients
```
public static void stopOtherClients()
                             throws ClientVmNotFoundException
```
    Stops and restarts a client vm.
    
    Throws:
    
    java.lang.Exception - / public static void stopAndRestartClient()throws Exception{ stopClient(); MasterController.sleepForMs(5000); startClient(); MasterController.sleepForMs(10000); } /** Stops all the clients listed in the roles.RolesPrms-clientsToStop property from the conf file.
    
    ClientVmNotFoundException.
    
    ClientVmNotFoundException
  - stopAndRestartRandomRolePlayingClients
```
public static void stopAndRestartRandomRolePlayingClients()
                                                   throws ClientVmNotFoundException,
                                                          java.lang.Exception
```
    Stops and restarts a random client from a vector of clients configured in the conf file by "roles.RolesPrms-clientsToStop" property. This task is called multiple times from "reconnectRandomRolePlayerShutDown.conf".
    
    Throws:
    
    ClientVmNotFoundException
    
    java.lang.Exception
  - stopClient
```
public static void stopClient(java.lang.String theClient)
                       throws ClientVmNotFoundException
```
    Stops a particular client specified by the parameter.
    
    Throws:
    
    ClientVmNotFoundException
  - startClient
```
public static void startClient(java.lang.String theClient)
```
  - printRegions
```
public static void printRegions()
                         throws java.lang.Exception
```
    Prints all the root regions in the cache. Helps while debugging reconnect issues with integrity problems.
    
    Throws:
    
    java.lang.Exception
  - stopClient
```
public static void stopClient()
                       throws ClientVmNotFoundException
```
    Stops a client specified by the roles.RolesPrms-clientsToStop parameter.
    
    Throws:
    
    ClientVmNotFoundException
  - startClient
```
public static void startClient()
                        throws ClientVmNotFoundException
```
    Throws:
    
    ClientVmNotFoundException
  - doSomeThing
```
public static void doSomeThing()
```
    Keeps the vm alive for hydra.

Class SustainabilityTest

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

SustainabilityTest

Method Detail

generateXml

generateXmlWithMultiRequiredRoles

generateXml

generateABRegionRequiredXml

createRolePlayerVm

createSingleRegionRequiresRoleAB

createSelfRolePlayingVm

createRolePlayerAVm

createRolePlayerBVm

createRolePlayerCVm

createRolePlayerDVm

createRolePlayerEVm

createRolePlayerFVm

createRolePlayerGVm

createCacheAndRegionsWithRoleLoss

createCacheAndRegionsWithBackUp

createCacheRequiresABFromXML

validateCacheCreation

createMultiRegionRequireRoles

validateSelfRolePlayerClient

checkGetInitialImageStats

putRegionA

putRegionB

putKeysValuesRegionA

putKeysValuesRegionB

putKeysValuesRegionC

putKeysValuesRegionD

putKeysValuesRegionE

putKeysValuesRegionF

putKeysValuesRegionG

putKeysValues

stopOtherClients

stopAndRestartRandomRolePlayingClients

stopClient

startClient

printRegions

stopClient

startClient

doSomeThing