Package alluxio.master

Class MultiMasterLocalAlluxioCluster

java.lang.Object

alluxio.master.AbstractLocalAlluxioCluster

alluxio.master.MultiMasterLocalAlluxioCluster

@NotThreadSafe
public final class MultiMasterLocalAlluxioCluster
extends AbstractLocalAlluxioCluster

A local Alluxio cluster with multiple masters.

Field Summary

Fields inherited from class alluxio.master.AbstractLocalAlluxioCluster

mHostname, mProxyProcess, mProxyThread, mWorkDirectory, mWorkers, mWorkerThreads

Constructor Summary

Constructors

Constructor	Description
MultiMasterLocalAlluxioCluster(int numMasters)	Runs a multi master local Alluxio cluster with a single worker.
MultiMasterLocalAlluxioCluster(int numMasters, int numWorkers)

Method Summary

Modifier and Type	Method	Description
alluxio.client.file.FileSystem	getClient()	Returns a FileSystem client.
alluxio.client.file.FileSystem	getClient(alluxio.client.file.FileSystemContext context)
int	getLeaderIndex()
LocalAlluxioMaster	getLocalAlluxioMaster()
java.util.List<java.net.InetSocketAddress>	getMasterAddresses()
java.lang.String	getUri()
void	initConfiguration(java.lang.String name)	Creates a default Configuration for testing.
void	restartZk()	Restarts the cluster's Zookeeper service.
protected void	startMasters()	Configures and starts the master(s).
void	startWorkers()	Configures and starts the worker(s).
void	stopFS()	Stops the alluxio filesystem's service thread only.
boolean	stopLeader()	Iterates over the masters in the order of master creation, stops the leader master.
void	stopMasters()	Stops the masters.
boolean	stopStandby()	Iterates over the masters in the order of master creation, stops the first standby master.
void	stopZk()	Stops the cluster's Zookeeper service.
void	waitForNewMaster(int timeoutMs)	Waits for a new master to start until a timeout occurs.

Methods inherited from class alluxio.master.AbstractLocalAlluxioCluster

formatAndRestartMasters, getProxyProcess, isStartedWorkers, reset, resetClientPools, restartMasters, setAlluxioWorkDirectory, setHostname, setupTest, start, startProxy, stop, stopProxy, stopWorkers, waitForMasterServing, waitForWorkersRegistered

Methods inherited from class java.lang.Object

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

Constructor Detail

MultiMasterLocalAlluxioCluster

public MultiMasterLocalAlluxioCluster(int numMasters)

Runs a multi master local Alluxio cluster with a single worker.

Parameters:

numMasters - the number masters to run

MultiMasterLocalAlluxioCluster

public MultiMasterLocalAlluxioCluster(int numMasters,
                                      int numWorkers)

Parameters:

numMasters - the number of masters to run

numWorkers - the number of workers to run

Method Detail

initConfiguration

public void initConfiguration(java.lang.String name)
                       throws java.io.IOException

Description copied from class: AbstractLocalAlluxioCluster

Creates a default Configuration for testing.

Specified by:

initConfiguration in class AbstractLocalAlluxioCluster

Parameters:

name - the name of the test/cluster

Throws:

java.io.IOException

getClient

public alluxio.client.file.FileSystem getClient()
                                         throws java.io.IOException

Description copied from class: AbstractLocalAlluxioCluster

Returns a FileSystem client.

Specified by:

getClient in class AbstractLocalAlluxioCluster

Returns:

a FileSystem client

Throws:

java.io.IOException

getClient

public alluxio.client.file.FileSystem getClient(alluxio.client.file.FileSystemContext context)
                                         throws java.io.IOException

Specified by:

getClient in class AbstractLocalAlluxioCluster

Parameters:

context - the FileSystemContext to use

Returns:

a FileSystem client, using a specific context

Throws:

java.io.IOException

getUri

public java.lang.String getUri()

Returns:

the URI of the master

getLocalAlluxioMaster

public LocalAlluxioMaster getLocalAlluxioMaster()

Specified by:

getLocalAlluxioMaster in class AbstractLocalAlluxioCluster

Returns:

the local Alluxio master

getLeaderIndex

public int getLeaderIndex()

Returns:

index of leader master in mMasters, or -1 if there is no leader temporarily

getMasterAddresses

public java.util.List<java.net.InetSocketAddress> getMasterAddresses()

Returns:

the master addresses

stopStandby

public boolean stopStandby()

Iterates over the masters in the order of master creation, stops the first standby master.

Returns:

true if a standby master is successfully stopped, otherwise, false

stopLeader

public boolean stopLeader()

Iterates over the masters in the order of master creation, stops the leader master.

Returns:

true if the leader master is successfully stopped, false otherwise

waitForNewMaster

public void waitForNewMaster(int timeoutMs)
                      throws java.util.concurrent.TimeoutException,
                             java.lang.InterruptedException

Waits for a new master to start until a timeout occurs.

Parameters:

timeoutMs - the number of milliseconds to wait before giving up and throwing an exception

Throws:

java.util.concurrent.TimeoutException

java.lang.InterruptedException

stopZk

public void stopZk()
            throws java.lang.Exception

Stops the cluster's Zookeeper service.

Throws:

java.lang.Exception

restartZk

public void restartZk()
               throws java.lang.Exception

Restarts the cluster's Zookeeper service. It must first be stopped with stopZk().

Throws:

java.lang.Exception

startMasters

protected void startMasters()
                     throws java.io.IOException

Description copied from class: AbstractLocalAlluxioCluster

Configures and starts the master(s).

Specified by:

startMasters in class AbstractLocalAlluxioCluster

Throws:

java.io.IOException

startWorkers

public void startWorkers()
                  throws java.lang.Exception

Description copied from class: AbstractLocalAlluxioCluster

Configures and starts the worker(s).

Overrides:

startWorkers in class AbstractLocalAlluxioCluster

Throws:

java.lang.Exception

stopFS

public void stopFS()
            throws java.lang.Exception

Description copied from class: AbstractLocalAlluxioCluster

Stops the alluxio filesystem's service thread only.

Overrides:

stopFS in class AbstractLocalAlluxioCluster

Throws:

java.lang.Exception

stopMasters

public void stopMasters()
                 throws java.lang.Exception

Description copied from class: AbstractLocalAlluxioCluster

Stops the masters.

Specified by:

stopMasters in class AbstractLocalAlluxioCluster

Throws:

java.lang.Exception