alluxio.master

Class LocalAlluxioCluster

java.lang.Object

alluxio.master.AbstractLocalAlluxioCluster

alluxio.master.LocalAlluxioCluster

@NotThreadSafe
public final class LocalAlluxioCluster
extends AbstractLocalAlluxioCluster

Local Alluxio cluster for integration tests. Example to use

 // Create a cluster instance
 localAlluxioCluster = new LocalAlluxioCluster(WORKER_CAPACITY_BYTES, BLOCK_SIZE_BYTES);
 // If you have special conf parameter to set for integration tests:
 Configuration testConf = localAlluxioCluster.newTestConf();
 testConf.set(Constants.USER_FILE_BUFFER_BYTES, String.valueOf(BUFFER_BYTES));
 // After setting up the test conf, start this local cluster:
 localAlluxioCluster.start(testConf);
 

Field Summary

Fields inherited from class alluxio.master.AbstractLocalAlluxioCluster

LOG, mHome, mHostname, mMasterConf, mUfsCluster, mUserBlockSize, mWorker, mWorkerCapacityBytes, mWorkerConf, mWorkerThread

Constructor Summary

Constructors

Constructor and Description
LocalAlluxioCluster(long workerCapacityBytes, int userBlockSize)

Method Summary

Methods

Modifier and Type	Method and Description
String	getAlluxioHome()
FileSystem	getClient() Returns a FileSystem client.
LocalAlluxioMaster	getMaster() Gets the master which should be listening for RPC and Web requests.
String	getMasterHostname()
int	getMasterPort()
String	getMasterUri()
AlluxioWorker	getWorker()
WorkerNetAddress	getWorkerAddress()
Configuration	getWorkerConf()
protected void	resetContext() Resets contexts.
protected void	startMaster(Configuration testConf) Configures and starts a master.
protected void	startWorker(Configuration conf) Configures and starts a worker.
void	stop() Stops both the alluxio and underfs service threads.
void	stopTFS() Stops the alluxio filesystem's service thread only.
void	stopWorker() Cleans up the worker state from the master and stops the worker.

Methods inherited from class alluxio.master.AbstractLocalAlluxioCluster

getMasterConf, newTestConf, runWorker, setAlluxioHome, setHostname, setupTest, start, start, stopUFS

Methods inherited from class java.lang.Object

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

Constructor Detail

LocalAlluxioCluster

public LocalAlluxioCluster(long workerCapacityBytes,
                   int userBlockSize)

Parameters:

workerCapacityBytes - the capacity of the worker in bytes

userBlockSize - the block size for a user

Method Detail

getClient

public FileSystem getClient()
                     throws IOException

Description copied from class: AbstractLocalAlluxioCluster

Returns a FileSystem client.

Specified by:

getClient in class AbstractLocalAlluxioCluster

Returns:

a FileSystem client

Throws:

IOException - when the operation fails

getMaster

public LocalAlluxioMaster getMaster()

Description copied from class: AbstractLocalAlluxioCluster

Gets the master which should be listening for RPC and Web requests.

Specified by:

getMaster in class AbstractLocalAlluxioCluster

getMasterHostname

public String getMasterHostname()

Returns:

the hostname of the master

getMasterUri

public String getMasterUri()

Returns:

the URI of the master

getMasterPort

public int getMasterPort()

Returns:

the port of the master

getAlluxioHome

public String getAlluxioHome()

Returns:

the home path to Alluxio

getWorker

public AlluxioWorker getWorker()

Returns:

the worker

getWorkerConf

public Configuration getWorkerConf()

Returns:

the configuration for Alluxio

getWorkerAddress

public WorkerNetAddress getWorkerAddress()

Returns:

the address of the worker

startMaster

protected void startMaster(Configuration testConf)
                    throws IOException

Description copied from class: AbstractLocalAlluxioCluster

Configures and starts a master.

Specified by:

startMaster in class AbstractLocalAlluxioCluster

Parameters:

testConf - configuration of this test

Throws:

IOException - when the operation fails

startWorker

protected void startWorker(Configuration conf)
                    throws IOException,
                           ConnectionFailedException

Description copied from class: AbstractLocalAlluxioCluster

Configures and starts a worker.

Specified by:

startWorker in class AbstractLocalAlluxioCluster

Parameters:

conf - configuration of this test

Throws:

IOException - if an I/O error occurs

ConnectionFailedException - if network connection failed

resetContext

protected void resetContext()

Description copied from class: AbstractLocalAlluxioCluster

Resets contexts. This is called when the cluster is stopped.

Overrides:

resetContext in class AbstractLocalAlluxioCluster

stopTFS

public void stopTFS()
             throws Exception

Description copied from class: AbstractLocalAlluxioCluster

Stops the alluxio filesystem's service thread only.

Specified by:

stopTFS in class AbstractLocalAlluxioCluster

Throws:

Exception - when the operation fails

stopWorker

public void stopWorker()
                throws Exception

Cleans up the worker state from the master and stops the worker.

Throws:

Exception - when the operation fails

stop

public void stop()
          throws Exception

Description copied from class: AbstractLocalAlluxioCluster

Stops both the alluxio and underfs service threads.

Overrides:

stop in class AbstractLocalAlluxioCluster

Throws:

Exception - when the operation fails