Package org.apache.accumulo.miniclusterImpl

Class MiniAccumuloClusterImpl

java.lang.Object

org.apache.accumulo.miniclusterImpl.MiniAccumuloClusterImpl

All Implemented Interfaces:

AccumuloCluster

public class MiniAccumuloClusterImpl
extends Object
implements AccumuloCluster

This class provides the backing implementation for MiniAccumuloCluster, and may contain features for internal testing which have not yet been promoted to the public API. It's best to use MiniAccumuloCluster whenever possible. Use of this class risks API breakage between versions.

Since:

1.6.0

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	MiniAccumuloClusterImpl.ProcessInfo

Constructor Summary

Constructors

Constructor	Description
MiniAccumuloClusterImpl(File dir, String rootPassword)
MiniAccumuloClusterImpl(MiniAccumuloConfigImpl config)

Method Summary

Modifier and Type	Method	Description
MiniAccumuloClusterImpl.ProcessInfo	_exec(Class<?> clazz, ServerType serverType, Map<String,String> configOverrides, String... args)
MiniAccumuloClusterImpl.ProcessInfo	_exec(KeywordExecutable server, ServerType serverType, Map<String,String> configOverrides, String... args)
AccumuloClient	createAccumuloClient(String user, AuthenticationToken token)
MiniAccumuloClusterImpl.ProcessInfo	exec(Class<?> clazz, String... args)
MiniAccumuloClusterImpl.ProcessInfo	exec(Class<?> clazz, List<String> jvmArgs, String... args)
String	getAccumuloPropertiesPath()
ClientConfiguration	getClientConfig()	Get the client configuration for the cluster
Properties	getClientProperties()
String	getClientPropsPath()
MiniAccumuloClusterControl	getClusterControl()	Get an object that can manage a cluster
MiniAccumuloConfigImpl	getConfig()
Set<Pair<ServerType,Integer>>	getDebugPorts()
org.apache.hadoop.fs.FileSystem	getFileSystem()
String	getInstanceName()
ManagerMonitorInfo	getManagerMonitorInfo()	Get programmatic interface to information available in a normal monitor.
org.apache.hadoop.hdfs.MiniDFSCluster	getMiniDfs()
Map<ServerType,Collection<ProcessReference>>	getProcesses()
ServerContext	getServerContext()
protected ExecutorService	getShutdownExecutor()
AccumuloConfiguration	getSiteConfiguration()	Get server side config derived from accumulo.properties
org.apache.hadoop.fs.Path	getTemporaryPath()
String	getZooKeepers()
void	killProcess(ServerType type, ProcessReference proc)
protected void	setShutdownExecutor(ExecutorService svc)
void	start()	Starts Accumulo and Zookeeper processes.
void	stop()	Stops Accumulo and Zookeeper processes.
int	stopProcessWithTimeout(Process proc, long timeout, TimeUnit unit)

Methods inherited from class java.lang.Object

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

Constructor Detail

MiniAccumuloClusterImpl

public MiniAccumuloClusterImpl(File dir,
                               String rootPassword)
                        throws IOException

Parameters:

dir - An empty or nonexistent temp directory that Accumulo and Zookeeper can store data in. Creating the directory is left to the user. Java 7, Guava, and Junit provide methods for creating temporary directories.

rootPassword - Initial root password for instance.

Throws:

IOException

MiniAccumuloClusterImpl

public MiniAccumuloClusterImpl(MiniAccumuloConfigImpl config)
                        throws IOException

Parameters:

config - initial configuration

Throws:

IOException

Method Detail

exec

public MiniAccumuloClusterImpl.ProcessInfo exec(Class<?> clazz,
                                                String... args)
                                         throws IOException

Throws:

IOException

exec

public MiniAccumuloClusterImpl.ProcessInfo exec(Class<?> clazz,
                                                List<String> jvmArgs,
                                                String... args)
                                         throws IOException

Throws:

IOException

_exec

public MiniAccumuloClusterImpl.ProcessInfo _exec(KeywordExecutable server,
                                                 ServerType serverType,
                                                 Map<String,String> configOverrides,
                                                 String... args)
                                          throws IOException

Throws:

IOException

_exec

public MiniAccumuloClusterImpl.ProcessInfo _exec(Class<?> clazz,
                                                 ServerType serverType,
                                                 Map<String,String> configOverrides,
                                                 String... args)
                                          throws IOException

Throws:

IOException

start

public void start()
           throws IOException,
                  InterruptedException

Starts Accumulo and Zookeeper processes. Can only be called once.

Specified by:

start in interface AccumuloCluster

Throws:

IOException

InterruptedException

getDebugPorts

public Set<Pair<ServerType,Integer>> getDebugPorts()

Returns:

generated remote debug ports if in debug mode.

Since:

1.6.0

getProcesses

public Map<ServerType,Collection<ProcessReference>> getProcesses()

killProcess

public void killProcess(ServerType type,
                        ProcessReference proc)
                 throws ProcessNotFoundException,
                        InterruptedException

Throws:

ProcessNotFoundException

InterruptedException

getInstanceName

public String getInstanceName()

Specified by:

getInstanceName in interface AccumuloCluster

Returns:

Accumulo instance name

getZooKeepers

public String getZooKeepers()

Specified by:

getZooKeepers in interface AccumuloCluster

Returns:

zookeeper connection string

getServerContext

public ServerContext getServerContext()

Specified by:

getServerContext in interface AccumuloCluster

Returns:

ServerContext

stop

public void stop()
          throws IOException,
                 InterruptedException

Stops Accumulo and Zookeeper processes. If stop is not called, there is a shutdown hook that is setup to kill the processes. However it's probably best to call stop in a finally block as soon as possible.

Specified by:

stop in interface AccumuloCluster

Throws:

IOException

InterruptedException

getConfig

public MiniAccumuloConfigImpl getConfig()

Since:

1.6.0

createAccumuloClient

public AccumuloClient createAccumuloClient(String user,
                                           AuthenticationToken token)

Specified by:

createAccumuloClient in interface AccumuloCluster

Returns:

AccumuloClient that must be closed by user

getClientConfig

public ClientConfiguration getClientConfig()

Description copied from interface: AccumuloCluster

Get the client configuration for the cluster

Specified by:

getClientConfig in interface AccumuloCluster

getClientProperties

public Properties getClientProperties()

Specified by:

getClientProperties in interface AccumuloCluster

Returns:

client connection info for cluster

getFileSystem

public org.apache.hadoop.fs.FileSystem getFileSystem()

Specified by:

getFileSystem in interface AccumuloCluster

Returns:

the FileSystem in use by this cluster

setShutdownExecutor

protected void setShutdownExecutor(ExecutorService svc)

getShutdownExecutor

protected ExecutorService getShutdownExecutor()

stopProcessWithTimeout

public int stopProcessWithTimeout(Process proc,
                                  long timeout,
                                  TimeUnit unit)
                           throws InterruptedException,
                                  ExecutionException,
                                  TimeoutException

Throws:

InterruptedException

ExecutionException

TimeoutException

getManagerMonitorInfo

public ManagerMonitorInfo getManagerMonitorInfo()
                                         throws AccumuloException,
                                                AccumuloSecurityException

Get programmatic interface to information available in a normal monitor. XXX the returned structure won't contain information about the metadata table until there is data in it. e.g. if you want to see the metadata table you should create a table.

Throws:

AccumuloException

AccumuloSecurityException

Since:

1.6.1

getMiniDfs

public org.apache.hadoop.hdfs.MiniDFSCluster getMiniDfs()

getClusterControl

public MiniAccumuloClusterControl getClusterControl()

Description copied from interface: AccumuloCluster

Get an object that can manage a cluster

Specified by:

getClusterControl in interface AccumuloCluster

Returns:

Manage the state of the cluster

getTemporaryPath

public org.apache.hadoop.fs.Path getTemporaryPath()

Specified by:

getTemporaryPath in interface AccumuloCluster

Returns:

A path on FileSystem this cluster is running on that can be used for temporary files

getSiteConfiguration

public AccumuloConfiguration getSiteConfiguration()

Description copied from interface: AccumuloCluster

Get server side config derived from accumulo.properties

Specified by:

getSiteConfiguration in interface AccumuloCluster

getAccumuloPropertiesPath

public String getAccumuloPropertiesPath()

Specified by:

getAccumuloPropertiesPath in interface AccumuloCluster

Returns:

Path to accumulo.properties

getClientPropsPath

public String getClientPropsPath()

Specified by:

getClientPropsPath in interface AccumuloCluster

Returns:

Path to accumulo-client.properties