org.apache.hadoop.yarn.server.nodemanager

Class LinuxContainerExecutor

java.lang.Object

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

org.apache.hadoop.yarn.server.nodemanager.LinuxContainerExecutor

All Implemented Interfaces:

org.apache.hadoop.conf.Configurable

public class LinuxContainerExecutor
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
LinuxContainerExecutor()

Method Summary

Modifier and Type	Method and Description
protected void	addSchedPriorityCommand(List<String> command)
void	buildMainArgs(List<String> command, String user, String appId, String locId, InetSocketAddress nmAddr, List<String> localDirs)
void	deleteAsUser(String user, org.apache.hadoop.fs.Path dir, org.apache.hadoop.fs.Path... baseDirs)
protected String	getContainerExecutorExecutablePath(org.apache.hadoop.conf.Configuration conf)
void	init() Run the executor initialization steps.
boolean	isContainerProcessAlive(String user, String pid)
int	launchContainer(Container container, org.apache.hadoop.fs.Path nmPrivateCotainerScriptPath, org.apache.hadoop.fs.Path nmPrivateTokensPath, String user, String appId, org.apache.hadoop.fs.Path containerWorkDir, List<String> localDirs, List<String> logDirs) Launch the container on the node.
void	mountCgroups(List<String> cgroupKVs, String hierarchy)
int	reacquireContainer(String user, org.apache.hadoop.yarn.api.records.ContainerId containerId) Recover an already existing container.
void	setConf(org.apache.hadoop.conf.Configuration conf)
boolean	signalContainer(String user, String pid, ContainerExecutor.Signal signal)
void	startLocalizer(org.apache.hadoop.fs.Path nmPrivateContainerTokensPath, InetSocketAddress nmAddr, String user, String appId, String locId, LocalDirsHandlerService dirsHandler) 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, getRunCommand, isContainerActive, localizeClasspathJar, logOutput, writeLaunchEnv

Methods inherited from class java.lang.Object

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

Constructor Detail

LinuxContainerExecutor

public LinuxContainerExecutor()

Method Detail

setConf

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

Specified by:

setConf in interface org.apache.hadoop.conf.Configurable

Overrides:

setConf in class ContainerExecutor

getContainerExecutorExecutablePath

protected String getContainerExecutorExecutablePath(org.apache.hadoop.conf.Configuration conf)

addSchedPriorityCommand

protected void addSchedPriorityCommand(List<String> command)

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,
                           InetSocketAddress nmAddr,
                           String user,
                           String appId,
                           String locId,
                           LocalDirsHandlerService dirsHandler)
                    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

nmAddr - RPC address to contact NM

user - user name of application owner

appId - id of the application

dirsHandler - NM local dirs service, for nm-local-dirs and nm-log-dirs

Throws:

IOException - For most application init failures

InterruptedException - If application init thread is halted by NM

buildMainArgs

public void buildMainArgs(List<String> command,
                          String user,
                          String appId,
                          String locId,
                          InetSocketAddress nmAddr,
                          List<String> localDirs)

launchContainer

public int launchContainer(Container container,
                           org.apache.hadoop.fs.Path nmPrivateCotainerScriptPath,
                           org.apache.hadoop.fs.Path nmPrivateTokensPath,
                           String user,
                           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

nmPrivateCotainerScriptPath - the path for launch script

nmPrivateTokensPath - the path for tokens for the container

user - 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

reacquireContainer

public int reacquireContainer(String user,
                              org.apache.hadoop.yarn.api.records.ContainerId containerId)
                       throws IOException,
                              InterruptedException

Description copied from class: ContainerExecutor

Recover an already existing container. This is a blocking call and returns only when the container exits. Note that the container must have been activated prior to this call.

Overrides:

reacquireContainer in class ContainerExecutor

Parameters:

user - the user of the container

containerId - The ID of the container to reacquire

Returns:

The exit code of the pre-existing container

Throws:

IOException

InterruptedException

signalContainer

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

Specified by:

signalContainer in class ContainerExecutor

Throws:

IOException

deleteAsUser

public void deleteAsUser(String user,
                         org.apache.hadoop.fs.Path dir,
                         org.apache.hadoop.fs.Path... baseDirs)

Specified by:

deleteAsUser in class ContainerExecutor

isContainerProcessAlive

public boolean isContainerProcessAlive(String user,
                                       String pid)
                                throws IOException

Specified by:

isContainerProcessAlive in class ContainerExecutor

Throws:

IOException

mountCgroups

public void mountCgroups(List<String> cgroupKVs,
                         String hierarchy)
                  throws IOException

Throws:

IOException