hydra

Class MasterController

java.lang.Object

hydra.MasterController

public class MasterController
extends Object

This class acts as the master controller for hydra tests. It has overall responsibility for parsing config files, starting clients, scheduling test jobs, and so on.

Run a hydra test by first selecting a configuration file. To override hydra configuration parameters set in the file, create a "local.conf" file in the directory where the master will be run.

Usage:

    java -server -DJTESTS=<path_to_test_classes>
         -Dgemfire.home=<path_to_gemfire_product_tree>
         -DconfigFileName=<absolute_path_to_hydra_configuration_file>
          [optional_test_specific_system_properties]
         hydra.MasterController
  

Example:

     java -server 
          -classpath $GEMFIRE/lib/gemfire.jar:$JTESTS:$JTESTS/junit.jar
          -DJTESTS=$JTESTS
          -Dgemfire.home=$GEMFIRE
          -DconfigFileName=$JTESTS/hydra/samples/connclient.bt
          -DscalingFactorForMyTest=20
          hydra.MasterController
  

Test-specific system properties must be specified for all system properties used in the test configuration file, if any. See hydra_grammar.txt, batterytest_grammar.txt, and BatteryTest for more details.

The test will generate log files in the directory where the master controller was started. Master*.log is the primary log for the master. During the actual test execution it logs to taskmaster*.log. At the end of the test, the Master*.log will indicate whether the test passed or failed.

See BatteryTest for a convenient alternative for running suites of hydra tests.

Field Summary

Fields

Modifier and Type	Field and Description
static com.gemstone.gemfire.LogWriter	log Log for this vm
static String	RMI_HOST_PROPERTY
static String	RMI_NAME
static String	RMI_PORT_PROPERTY

Constructor Summary

Constructors

Constructor and Description
MasterController()

Method Summary

Modifier and Type	Method and Description
protected static void	dumpStacks()
protected static void	dumpStacks(int times)
protected static void	dumpStacksOnError(int times)
protected static String	getNameFor(int vmid, int tid, String clientName, String host, int pid) Used to name log files and threads.
static Object	invoke(String classname, String methodname) Invokes the specified method on an instance of the specified class.
static Object	invoke(String classname, String methodname, Class[] types, Object[] args) Invokes the specified method on an instance of the specified class.
static void	main(String[] ignore)
static void	sleepForMs(int msToSleep) Sleep "soundly" for msToSleep milliseconds.

Methods inherited from class java.lang.Object

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

Field Detail

RMI_NAME

public static final String RMI_NAME

See Also:

Constant Field Values

RMI_HOST_PROPERTY

public static final String RMI_HOST_PROPERTY

See Also:

Constant Field Values

RMI_PORT_PROPERTY

public static final String RMI_PORT_PROPERTY

See Also:

Constant Field Values

log

public static com.gemstone.gemfire.LogWriter log

Log for this vm

Constructor Detail

MasterController

public MasterController()

Method Detail

sleepForMs

public static void sleepForMs(int msToSleep)

Sleep "soundly" for msToSleep milliseconds.

getNameFor

protected static String getNameFor(int vmid,
                                   int tid,
                                   String clientName,
                                   String host,
                                   int pid)

Used to name log files and threads.

invoke

public static Object invoke(String classname,
                            String methodname)

Invokes the specified method on an instance of the specified class. Intended for use by client threads. Note that the invocation is synchronized across clients, so this is suitable for things like lazily creating shared blackboards.

invoke

public static Object invoke(String classname,
                            String methodname,
                            Class[] types,
                            Object[] args)

Invokes the specified method on an instance of the specified class. Intended for use by client threads. Note that the invocation is synchronized across clients, so this is suitable for things like lazily creating shared blackboards.

dumpStacksOnError

protected static void dumpStacksOnError(int times)

dumpStacks

protected static void dumpStacks(int times)

dumpStacks

protected static void dumpStacks()

main

public static void main(String[] ignore)