org.apache.hadoop.hbase

Class IntegrationTestBase

java.lang.Object

org.apache.hadoop.hbase.util.AbstractHBaseTool

org.apache.hadoop.hbase.IntegrationTestBase

All Implemented Interfaces:

org.apache.hadoop.conf.Configurable, org.apache.hadoop.util.Tool

Direct Known Subclasses:

IntegrationTestAcidGuarantees, IntegrationTestBigLinkedList, IntegrationTestBulkLoad, IntegrationTestDDLMasterFailover, IntegrationTestIngest, IntegrationTestLoadAndVerify, IntegrationTestRegionReplicaPerf, IntegrationTestTableSnapshotInputFormat

public abstract class IntegrationTestBase
extends org.apache.hadoop.hbase.util.AbstractHBaseTool

Base class for HBase integration tests that want to use the Chaos Monkey. Usage: bin/hbase <sub_class_of_IntegrationTestBase> <options> Options: -h,--help Show usage -m,--monkey <arg> Which chaos monkey to run -monkeyProps <arg> The properties file for specifying chaos monkey properties. -ncc Option to not clean up the cluster at the end.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.hadoop.hbase.util.AbstractHBaseTool

org.apache.hadoop.hbase.util.AbstractHBaseTool.OptionsOrderComparator

Field Summary

Fields

Modifier and Type	Field and Description
static String	CHAOS_MONKEY_PROPS
private static org.slf4j.Logger	LOG
protected ChaosMonkey	monkey
static String	MONKEY_LONG_OPT
protected Properties	monkeyProps
protected String	monkeyToUse
static String	NO_CLUSTER_CLEANUP_LONG_OPT
protected boolean	noClusterCleanUp
protected IntegrationTestingUtility	util

Fields inherited from class org.apache.hadoop.hbase.util.AbstractHBaseTool

cmdLineArgs, conf, EXIT_FAILURE, EXIT_SUCCESS, LONG_HELP_OPTION, options, SHORT_HELP_OPTION

Constructor Summary

Constructors

Constructor and Description
IntegrationTestBase()
IntegrationTestBase(String monkeyToUse)

Method Summary

Modifier and Type	Method and Description
protected void	addOptions()
void	cleanUp()
void	cleanUpCluster()
void	cleanUpMonkey()
protected void	cleanUpMonkey(String why)
protected int	doWork()
protected abstract Set<String>	getColumnFamilies() Provides the name of the CFs that are protected from random Chaos monkey activity (alter)
org.apache.hadoop.conf.Configuration	getConf()
protected MonkeyFactory	getDefaultMonkeyFactory()
abstract org.apache.hadoop.hbase.TableName	getTablename() Provides the name of the table that is protected from random Chaos monkey activity
protected IntegrationTestingUtility	getTestingUtil(org.apache.hadoop.conf.Configuration conf)
static void	loadMonkeyProperties(Properties props, org.apache.hadoop.conf.Configuration conf) Loads entries from the provided conf into props when the configuration key is one that may be configuring ChaosMonkey actions.
protected void	processBaseOptions(org.apache.hbase.thirdparty.org.apache.commons.cli.CommandLine cmd) This allows tests that subclass children of this base class such as IntegrationTestReplication to include the base options without having to also include the options from the test.
protected void	processOptions(org.apache.hbase.thirdparty.org.apache.commons.cli.CommandLine cmd)
abstract int	runTestFromCommandLine()
void	setUp()
abstract void	setUpCluster()
void	setUpMonkey()
protected void	startMonkey()

Methods inherited from class org.apache.hadoop.hbase.util.AbstractHBaseTool

addOption, addOptNoArg, addOptNoArg, addOptWithArg, addOptWithArg, addRequiredOption, addRequiredOptWithArg, addRequiredOptWithArg, doStaticMain, getOptionAsDouble, getOptionAsInt, getOptionAsLong, newParser, parseArgs, parseInt, parseLong, printUsage, printUsage, processOldArgs, run, setConf

Methods inherited from class java.lang.Object

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

Field Detail

NO_CLUSTER_CLEANUP_LONG_OPT

public static final String NO_CLUSTER_CLEANUP_LONG_OPT

See Also:

Constant Field Values

MONKEY_LONG_OPT

public static final String MONKEY_LONG_OPT

See Also:

Constant Field Values

CHAOS_MONKEY_PROPS

public static final String CHAOS_MONKEY_PROPS

See Also:

Constant Field Values

LOG

private static final org.slf4j.Logger LOG

util

protected IntegrationTestingUtility util

monkey

protected ChaosMonkey monkey

monkeyToUse

protected String monkeyToUse

monkeyProps

protected Properties monkeyProps

noClusterCleanUp

protected boolean noClusterCleanUp

Constructor Detail

IntegrationTestBase

public IntegrationTestBase()

IntegrationTestBase

public IntegrationTestBase(String monkeyToUse)

Method Detail

addOptions

protected void addOptions()

Specified by:

addOptions in class org.apache.hadoop.hbase.util.AbstractHBaseTool

processBaseOptions

protected void processBaseOptions(org.apache.hbase.thirdparty.org.apache.commons.cli.CommandLine cmd)

This allows tests that subclass children of this base class such as IntegrationTestReplication to include the base options without having to also include the options from the test.

Parameters:

cmd - the command line

loadMonkeyProperties

public static void loadMonkeyProperties(Properties props,
                                        org.apache.hadoop.conf.Configuration conf)

Loads entries from the provided conf into props when the configuration key is one that may be configuring ChaosMonkey actions.

processOptions

protected void processOptions(org.apache.hbase.thirdparty.org.apache.commons.cli.CommandLine cmd)

Specified by:

processOptions in class org.apache.hadoop.hbase.util.AbstractHBaseTool

getConf

public org.apache.hadoop.conf.Configuration getConf()

Specified by:

getConf in interface org.apache.hadoop.conf.Configurable

Overrides:

getConf in class org.apache.hadoop.hbase.util.AbstractHBaseTool

doWork

protected int doWork()
              throws Exception

Specified by:

doWork in class org.apache.hadoop.hbase.util.AbstractHBaseTool

Throws:

Exception

setUp

public void setUp()
           throws Exception

Throws:

Exception

cleanUp

public void cleanUp()
             throws Exception

Throws:

Exception

setUpMonkey

public void setUpMonkey()
                 throws Exception

Throws:

Exception

getDefaultMonkeyFactory

protected MonkeyFactory getDefaultMonkeyFactory()

startMonkey

protected void startMonkey()
                    throws Exception

Throws:

Exception

cleanUpMonkey

public void cleanUpMonkey()
                   throws Exception

Throws:

Exception

cleanUpMonkey

protected void cleanUpMonkey(String why)
                      throws Exception

Throws:

Exception

getTestingUtil

protected IntegrationTestingUtility getTestingUtil(org.apache.hadoop.conf.Configuration conf)

setUpCluster

public abstract void setUpCluster()
                           throws Exception

Throws:

Exception

cleanUpCluster

public void cleanUpCluster()
                    throws Exception

Throws:

Exception

runTestFromCommandLine

public abstract int runTestFromCommandLine()
                                    throws Exception

Throws:

Exception

getTablename

public abstract org.apache.hadoop.hbase.TableName getTablename()

Provides the name of the table that is protected from random Chaos monkey activity

Returns:

table to not delete.

getColumnFamilies

protected abstract Set<String> getColumnFamilies()

Provides the name of the CFs that are protected from random Chaos monkey activity (alter)

Returns:

set of cf names to protect.