org.apache.hadoop.yarn.server.resourcemanager.scheduler.fair

Class AllocationFileLoaderService

java.lang.Object

org.apache.hadoop.service.AbstractService

org.apache.hadoop.yarn.server.resourcemanager.scheduler.fair.AllocationFileLoaderService

All Implemented Interfaces:

Closeable, AutoCloseable, org.apache.hadoop.service.Service

@InterfaceAudience.Public
@InterfaceStability.Unstable
public class AllocationFileLoaderService
extends org.apache.hadoop.service.AbstractService

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	AllocationFileLoaderService.Listener

Nested classes/interfaces inherited from interface org.apache.hadoop.service.Service

org.apache.hadoop.service.Service.STATE

Field Summary

Fields

Modifier and Type	Field and Description
static long	ALLOC_RELOAD_INTERVAL_MS Time to wait between checks of the allocation file
static long	ALLOC_RELOAD_WAIT_MS Time to wait after the allocation has been modified before reloading it (this is done to prevent loading a file that hasn't been fully written).
static org.apache.commons.logging.Log	LOG

Constructor Summary

Constructors

Constructor and Description
AllocationFileLoaderService()
AllocationFileLoaderService(org.apache.hadoop.yarn.util.Clock clock)

Method Summary

Methods

Modifier and Type	Method and Description
File	getAllocationFile(org.apache.hadoop.conf.Configuration conf) Path to XML file containing allocations.
void	init(org.apache.hadoop.conf.Configuration conf)
void	reloadAllocations() Updates the allocation list from the allocation config file.
void	setReloadListener(AllocationFileLoaderService.Listener reloadListener)
void	start()
void	stop()

Methods inherited from class org.apache.hadoop.service.AbstractService

close, getBlockers, getConfig, getFailureCause, getFailureState, getLifecycleHistory, getName, getServiceState, getStartTime, isInState, noteFailure, putBlocker, registerGlobalListener, registerServiceListener, removeBlocker, serviceInit, serviceStart, serviceStop, setConfig, toString, unregisterGlobalListener, unregisterServiceListener, waitForServiceToStop

Methods inherited from class java.lang.Object

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

Field Detail

LOG

public static final org.apache.commons.logging.Log LOG

ALLOC_RELOAD_INTERVAL_MS

public static final long ALLOC_RELOAD_INTERVAL_MS

Time to wait between checks of the allocation file

See Also:

Constant Field Values

ALLOC_RELOAD_WAIT_MS

public static final long ALLOC_RELOAD_WAIT_MS

Time to wait after the allocation has been modified before reloading it (this is done to prevent loading a file that hasn't been fully written).

See Also:

Constant Field Values

Constructor Detail

AllocationFileLoaderService

public AllocationFileLoaderService()

AllocationFileLoaderService

public AllocationFileLoaderService(org.apache.hadoop.yarn.util.Clock clock)

Method Detail

init

public void init(org.apache.hadoop.conf.Configuration conf)

Specified by:

init in interface org.apache.hadoop.service.Service

Overrides:

init in class org.apache.hadoop.service.AbstractService

start

public void start()

Specified by:

start in interface org.apache.hadoop.service.Service

Overrides:

start in class org.apache.hadoop.service.AbstractService

stop

public void stop()

Specified by:

stop in interface org.apache.hadoop.service.Service

Overrides:

stop in class org.apache.hadoop.service.AbstractService

getAllocationFile

public File getAllocationFile(org.apache.hadoop.conf.Configuration conf)

Path to XML file containing allocations. If the path is relative, it is searched for in the classpath, but loaded like a regular File.

setReloadListener

public void setReloadListener(AllocationFileLoaderService.Listener reloadListener)

reloadAllocations

public void reloadAllocations()
                       throws IOException,
                              ParserConfigurationException,
                              SAXException,
                              AllocationConfigurationException

Updates the allocation list from the allocation config file. This file is expected to be in the XML format specified in the design doc.

Throws:

IOException - if the config file cannot be read.

AllocationConfigurationException - if allocations are invalid.

ParserConfigurationException - if XML parser is misconfigured.

SAXException - if config file is malformed.