org.apache.tez.dag.app

Class DAGAppMaster

java.lang.Object

org.apache.hadoop.service.AbstractService

org.apache.tez.dag.app.DAGAppMaster

All Implemented Interfaces:

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

public class DAGAppMaster
extends org.apache.hadoop.service.AbstractService

The Tez DAG Application Master. The state machine is encapsulated in the implementation of Job interface. All state changes happens via Job interface. Each event results in a Finite State Transition in Job. Tez DAG AppMaster is the composition of loosely coupled services. The services interact with each other via events. The components resembles the Actors model. The component acts on received event and send out the events to other components. This keeps it highly concurrent with no or minimal synchronization needs. The events are dispatched by a central Dispatch mechanism. All components register to the Dispatcher. The information is shared across different components using AppContext.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	DAGAppMaster.DAGAppMasterShutdownHandler

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
protected boolean	isLastAMRetry
static int	SHUTDOWN_HOOK_PRIORITY Priority of the DAGAppMaster shutdown hook.
protected DAGAppMaster.DAGAppMasterShutdownHandler	shutdownHandler

Constructor Summary

Constructors

Constructor and Description

DAGAppMaster(org.apache.hadoop.yarn.api.records.ApplicationAttemptId applicationAttemptId, org.apache.hadoop.yarn.api.records.ContainerId containerId, String nmHost, int nmPort, int nmHttpPort, org.apache.hadoop.yarn.util.Clock clock, long appSubmitTime, boolean isSession, String workingDirectory, String[] localDirs, String[] logDirs, String clientVersion, org.apache.hadoop.security.Credentials credentials, String jobUserName, org.apache.tez.dag.api.records.DAGProtos.AMPluginDescriptorProto pluginDescriptorProto)

Method Summary

Modifier and Type	Method and Description
protected void	addIfService(Object object, boolean addDispatcher)
protected void	addIfServiceDependency(Object object, Object dependency)
protected ContainerHeartbeatHandler	createContainerHeartbeatHandler(AppContext context, org.apache.hadoop.conf.Configuration conf)
protected ContainerLauncherManager	createContainerLauncherManager(List<org.apache.tez.dag.api.NamedEntityDescriptor> containerLauncherDescriptors, boolean isLocal)
protected org.apache.tez.common.ContainerSignatureMatcher	createContainerSignatureMatcher()
protected DAG	createDAG(org.apache.tez.dag.api.records.DAGProtos.DAGPlan dagPB)
protected org.apache.tez.common.AsyncDispatcher	createDispatcher()
protected HistoryEventHandler	createHistoryEventHandler(AppContext appContext)
protected DAGAppMaster.DAGAppMasterShutdownHandler	createShutdownHandler()
protected TaskCommunicatorManagerInterface	createTaskCommunicatorManager(AppContext context, TaskHeartbeatHandler thh, ContainerHeartbeatHandler chh, List<org.apache.tez.dag.api.NamedEntityDescriptor> entityDescriptors)
protected TaskHeartbeatHandler	createTaskHeartbeatHandler(AppContext context, org.apache.hadoop.conf.Configuration conf)
protected TaskSchedulerManager	createTaskSchedulerManager(List<org.apache.tez.dag.api.NamedEntityDescriptor> taskSchedulerDescriptors)
org.apache.tez.common.security.ACLManager	getACLManager()
org.apache.hadoop.yarn.api.records.ContainerId	getAppContainerId()
org.apache.hadoop.yarn.api.records.ApplicationId	getAppID()
String	getAppNMHost()
int	getAppNMHttpPort()
int	getAppNMPort()
org.apache.hadoop.yarn.api.records.ApplicationAttemptId	getAttemptID()
ContainerLauncherManager	getContainerLauncherManager()
AppContext	getContext()
List<String>	getDiagnostics()
org.apache.hadoop.yarn.event.Dispatcher	getDispatcher()
float	getProgress()
int	getRpcPort()
static String	getRunningLogURL(String nodeHttpAddress, String containerId, String user)
int	getStartCount()
DAGAppMasterState	getState()
TaskCommunicatorManagerInterface	getTaskCommunicatorManager()
protected TaskSchedulerManager	getTaskSchedulerManager()
protected void	handle(DAGAppMasterEvent event)
static void	initAndStartAppMaster(DAGAppMaster appMaster, org.apache.hadoop.conf.Configuration conf)
boolean	isSession()
static void	main(String[] args)
static void	parsePlugin(List<org.apache.tez.dag.api.NamedEntityDescriptor> resultList, com.google.common.collect.BiMap<String,Integer> pluginMap, List<org.apache.tez.dag.api.records.DAGProtos.TezNamedEntityDescriptorProto> namedEntityDescriptorProtos, boolean tezYarnEnabled, boolean uberEnabled, org.apache.tez.dag.api.UserPayload defaultPayload)
void	serviceInit(org.apache.hadoop.conf.Configuration conf)
void	serviceStart()
void	serviceStop()
void	setCurrentDAG(DAG currentDAG)
void	shutdownTezAM(String dagKillmessage)
String	submitDAGToAppMaster(org.apache.tez.dag.api.records.DAGProtos.DAGPlan dagPlan, Map<String,org.apache.hadoop.yarn.api.records.LocalResource> additionalResources)
protected void	sysexit() Exit call.
void	tryKillDAG(DAG dag, String message)

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

close, getBlockers, getConfig, getFailureCause, getFailureState, getLifecycleHistory, getName, getServiceState, getStartTime, init, isInState, noteFailure, putBlocker, registerGlobalListener, registerServiceListener, removeBlocker, setConfig, start, stop, toString, unregisterGlobalListener, unregisterServiceListener, waitForServiceToStop

Methods inherited from class java.lang.Object

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

Field Detail

SHUTDOWN_HOOK_PRIORITY

public static final int SHUTDOWN_HOOK_PRIORITY

Priority of the DAGAppMaster shutdown hook.

See Also:

Constant Field Values

shutdownHandler

protected DAGAppMaster.DAGAppMasterShutdownHandler shutdownHandler

isLastAMRetry

protected boolean isLastAMRetry

Constructor Detail

DAGAppMaster

public DAGAppMaster(org.apache.hadoop.yarn.api.records.ApplicationAttemptId applicationAttemptId,
                    org.apache.hadoop.yarn.api.records.ContainerId containerId,
                    String nmHost,
                    int nmPort,
                    int nmHttpPort,
                    org.apache.hadoop.yarn.util.Clock clock,
                    long appSubmitTime,
                    boolean isSession,
                    String workingDirectory,
                    String[] localDirs,
                    String[] logDirs,
                    String clientVersion,
                    org.apache.hadoop.security.Credentials credentials,
                    String jobUserName,
                    org.apache.tez.dag.api.records.DAGProtos.AMPluginDescriptorProto pluginDescriptorProto)

Method Detail

getRunningLogURL

public static String getRunningLogURL(String nodeHttpAddress,
                                      String containerId,
                                      String user)

serviceInit

public void serviceInit(org.apache.hadoop.conf.Configuration conf)
                 throws Exception

Overrides:

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

Throws:

Exception

createShutdownHandler

protected DAGAppMaster.DAGAppMasterShutdownHandler createShutdownHandler()

createTaskSchedulerManager

protected TaskSchedulerManager createTaskSchedulerManager(List<org.apache.tez.dag.api.NamedEntityDescriptor> taskSchedulerDescriptors)

createContainerSignatureMatcher

protected org.apache.tez.common.ContainerSignatureMatcher createContainerSignatureMatcher()

createDispatcher

protected org.apache.tez.common.AsyncDispatcher createDispatcher()

createHistoryEventHandler

protected HistoryEventHandler createHistoryEventHandler(AppContext appContext)

sysexit

protected void sysexit()

Exit call. Just in a function call to enable testing.

getTaskSchedulerManager

protected TaskSchedulerManager getTaskSchedulerManager()

handle

protected void handle(DAGAppMasterEvent event)

setCurrentDAG

public void setCurrentDAG(DAG currentDAG)

getACLManager

public org.apache.tez.common.security.ACLManager getACLManager()

createDAG

protected DAG createDAG(org.apache.tez.dag.api.records.DAGProtos.DAGPlan dagPB)

addIfService

protected void addIfService(Object object,
                            boolean addDispatcher)

addIfServiceDependency

protected void addIfServiceDependency(Object object,
                                      Object dependency)

createTaskCommunicatorManager

protected TaskCommunicatorManagerInterface createTaskCommunicatorManager(AppContext context,
                                                                         TaskHeartbeatHandler thh,
                                                                         ContainerHeartbeatHandler chh,
                                                                         List<org.apache.tez.dag.api.NamedEntityDescriptor> entityDescriptors)
                                                                  throws org.apache.tez.dag.api.TezException

Throws:

org.apache.tez.dag.api.TezException

createTaskHeartbeatHandler

protected TaskHeartbeatHandler createTaskHeartbeatHandler(AppContext context,
                                                          org.apache.hadoop.conf.Configuration conf)

createContainerHeartbeatHandler

protected ContainerHeartbeatHandler createContainerHeartbeatHandler(AppContext context,
                                                                    org.apache.hadoop.conf.Configuration conf)

createContainerLauncherManager

protected ContainerLauncherManager createContainerLauncherManager(List<org.apache.tez.dag.api.NamedEntityDescriptor> containerLauncherDescriptors,
                                                                  boolean isLocal)
                                                           throws UnknownHostException,
                                                                  org.apache.tez.dag.api.TezException

Throws:

UnknownHostException

org.apache.tez.dag.api.TezException

getAppID

public org.apache.hadoop.yarn.api.records.ApplicationId getAppID()

getAttemptID

public org.apache.hadoop.yarn.api.records.ApplicationAttemptId getAttemptID()

getStartCount

public int getStartCount()

getContext

public AppContext getContext()

getDispatcher

public org.apache.hadoop.yarn.event.Dispatcher getDispatcher()

getContainerLauncherManager

public ContainerLauncherManager getContainerLauncherManager()

getTaskCommunicatorManager

public TaskCommunicatorManagerInterface getTaskCommunicatorManager()

getAppContainerId

public org.apache.hadoop.yarn.api.records.ContainerId getAppContainerId()

getAppNMHost

public String getAppNMHost()

getAppNMPort

public int getAppNMPort()

getAppNMHttpPort

public int getAppNMHttpPort()

getRpcPort

public int getRpcPort()

getState

public DAGAppMasterState getState()

getDiagnostics

public List<String> getDiagnostics()

getProgress

public float getProgress()

shutdownTezAM

public void shutdownTezAM(String dagKillmessage)
                   throws org.apache.tez.dag.api.TezException

Throws:

org.apache.tez.dag.api.TezException

submitDAGToAppMaster

public String submitDAGToAppMaster(org.apache.tez.dag.api.records.DAGProtos.DAGPlan dagPlan,
                                   Map<String,org.apache.hadoop.yarn.api.records.LocalResource> additionalResources)
                            throws org.apache.tez.dag.api.TezException

Throws:

org.apache.tez.dag.api.TezException

tryKillDAG

public void tryKillDAG(DAG dag,
                       String message)
                throws org.apache.tez.dag.api.TezException

Throws:

org.apache.tez.dag.api.TezException

serviceStart

public void serviceStart()
                  throws Exception

Overrides:

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

Throws:

Exception

serviceStop

public void serviceStop()
                 throws Exception

Overrides:

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

Throws:

Exception

isSession

public boolean isSession()

main

public static void main(String[] args)

initAndStartAppMaster

public static void initAndStartAppMaster(DAGAppMaster appMaster,
                                         org.apache.hadoop.conf.Configuration conf)
                                  throws IOException,
                                         InterruptedException

Throws:

IOException

InterruptedException

parsePlugin

public static void parsePlugin(List<org.apache.tez.dag.api.NamedEntityDescriptor> resultList,
                               com.google.common.collect.BiMap<String,Integer> pluginMap,
                               List<org.apache.tez.dag.api.records.DAGProtos.TezNamedEntityDescriptorProto> namedEntityDescriptorProtos,
                               boolean tezYarnEnabled,
                               boolean uberEnabled,
                               org.apache.tez.dag.api.UserPayload defaultPayload)