org.apache.hadoop.yarn.server.nodemanager

Class DefaultContainerExecutor

java.lang.Object

org.apache.hadoop.yarn.server.nodemanager.ContainerExecutor

org.apache.hadoop.yarn.server.nodemanager.DefaultContainerExecutor

All Implemented Interfaces:

org.apache.hadoop.conf.Configurable

public class DefaultContainerExecutor
extends ContainerExecutor

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.hadoop.yarn.server.nodemanager.ContainerExecutor

ContainerExecutor.DelayedProcessKiller, ContainerExecutor.ExitCode, ContainerExecutor.Signal

Field Summary

Fields inherited from class org.apache.hadoop.yarn.server.nodemanager.ContainerExecutor

TASK_LAUNCH_SCRIPT_PERMISSION

Constructor Summary

Constructors

Constructor and Description
DefaultContainerExecutor()

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	containerIsAlive(String pid) Returns true if the process with the specified pid is alive.
void	deleteAsUser(String user, org.apache.hadoop.fs.Path subDir, org.apache.hadoop.fs.Path... baseDirs)
void	init() Run the executor initialization steps.
int	launchContainer(Container container, org.apache.hadoop.fs.Path nmPrivateContainerScriptPath, org.apache.hadoop.fs.Path nmPrivateTokensPath, org.apache.hadoop.fs.Path nmPrivateExtTokensPath, String extTokensEnvVar, String userName, String appId, org.apache.hadoop.fs.Path containerWorkDir, List<String> localDirs, List<String> logDirs) Launch the container on the node.
boolean	signalContainer(String user, String pid, ContainerExecutor.Signal signal)
void	startLocalizer(org.apache.hadoop.fs.Path nmPrivateContainerTokensPath, org.apache.hadoop.fs.Path nmPrivateExtTokensPath, String extTokensEnvVar, InetSocketAddress nmAddr, String user, String appId, String locId, List<String> localDirs, List<String> logDirs) Prepare the environment for containers in this application to execute.

Methods inherited from class org.apache.hadoop.yarn.server.nodemanager.ContainerExecutor

activateContainer, deactivateContainer, getConf, getPidFilePath, getProcessId, getRunCommand, isContainerActive, logOutput, setConf

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultContainerExecutor

public DefaultContainerExecutor()

Method Detail

init

public void init()
          throws IOException

Description copied from class: ContainerExecutor

Run the executor initialization steps. Verify that the necessary configs, permissions are in place.

Specified by:

init in class ContainerExecutor

Throws:

IOException

startLocalizer

public void startLocalizer(org.apache.hadoop.fs.Path nmPrivateContainerTokensPath,
                  org.apache.hadoop.fs.Path nmPrivateExtTokensPath,
                  String extTokensEnvVar,
                  InetSocketAddress nmAddr,
                  String user,
                  String appId,
                  String locId,
                  List<String> localDirs,
                  List<String> logDirs)
                    throws IOException,
                           InterruptedException

Description copied from class: ContainerExecutor

Prepare the environment for containers in this application to execute. For $x in local.dirs create $x/$user/$appId Copy $nmLocal/appTokens -> $N/$user/$appId For $rsrc in private resources Copy $rsrc -> $N/$user/filecache/[idef] For $rsrc in job resources Copy $rsrc -> $N/$user/$appId/filecache/idef

Specified by:

startLocalizer in class ContainerExecutor

Parameters:

nmPrivateContainerTokensPath - path to localized credentials, rsrc by NM

nmPrivateExtTokensPath - the path for any external tokens for the container - nullable

extTokensEnvVar - the name of the environment variable that points to external token path - nullable

nmAddr - RPC address to contact NM

user - user name of application owner

appId - id of the application

localDirs - nm-local-dirs

logDirs - nm-log-dirs

Throws:

IOException - For most application init failures

InterruptedException - If application init thread is halted by NM

launchContainer

public int launchContainer(Container container,
                  org.apache.hadoop.fs.Path nmPrivateContainerScriptPath,
                  org.apache.hadoop.fs.Path nmPrivateTokensPath,
                  org.apache.hadoop.fs.Path nmPrivateExtTokensPath,
                  String extTokensEnvVar,
                  String userName,
                  String appId,
                  org.apache.hadoop.fs.Path containerWorkDir,
                  List<String> localDirs,
                  List<String> logDirs)
                    throws IOException

Description copied from class: ContainerExecutor

Launch the container on the node. This is a blocking call and returns only when the container exits.

Specified by:

launchContainer in class ContainerExecutor

Parameters:

container - the container to be launched

nmPrivateContainerScriptPath - the path for launch script

nmPrivateTokensPath - the path for tokens for the container

nmPrivateExtTokensPath - the path for any external tokens for the container - nullable

extTokensEnvVar - the name of the environment variable that points to external token path - nullable

userName - the user of the container

appId - the appId of the container

containerWorkDir - the work dir for the container

localDirs - nm-local-dirs to be used for this container

logDirs - nm-log-dirs to be used for this container

Returns:

the return status of the launch

Throws:

IOException

signalContainer

public boolean signalContainer(String user,
                      String pid,
                      ContainerExecutor.Signal signal)
                        throws IOException

Specified by:

signalContainer in class ContainerExecutor

Throws:

IOException

containerIsAlive

public static boolean containerIsAlive(String pid)
                                throws IOException

Returns true if the process with the specified pid is alive.

Parameters:

pid - String pid

Returns:

boolean true if the process is alive

Throws:

IOException

deleteAsUser

public void deleteAsUser(String user,
                org.apache.hadoop.fs.Path subDir,
                org.apache.hadoop.fs.Path... baseDirs)
                  throws IOException,
                         InterruptedException

Specified by:

deleteAsUser in class ContainerExecutor

Throws:

IOException

InterruptedException