Package org.apache.hadoop.mapred

Class LocalJobRunner

java.lang.Object

org.apache.hadoop.mapred.LocalJobRunner

All Implemented Interfaces:

org.apache.hadoop.ipc.VersionedProtocol, org.apache.hadoop.mapreduce.protocol.ClientProtocol

@Private
@Unstable
public class LocalJobRunner
extends java.lang.Object
implements org.apache.hadoop.mapreduce.protocol.ClientProtocol

Implements MapReduce locally, in-process, for debugging.

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	INTERMEDIATE_DATA_ENCRYPTION_ALGO
static java.lang.String	LOCAL_MAX_MAPS	The maximum number of map tasks to run in parallel in LocalJobRunner
static java.lang.String	LOCAL_MAX_REDUCES	The maximum number of reduce tasks to run in parallel in LocalJobRunner
static org.slf4j.Logger	LOG

Fields inherited from interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

versionID

Constructor Summary

Constructors

Constructor	Description
LocalJobRunner(org.apache.hadoop.conf.Configuration conf)
LocalJobRunner(org.apache.hadoop.mapred.JobConf conf)	Deprecated.

Method Summary

Modifier and Type	Method	Description
void	cancelDelegationToken(org.apache.hadoop.security.token.Token<org.apache.hadoop.mapreduce.security.token.delegation.DelegationTokenIdentifier> token)
org.apache.hadoop.mapreduce.TaskTrackerInfo[]	getActiveTrackers()	Get all active trackers in cluster.
org.apache.hadoop.mapreduce.JobStatus[]	getAllJobs()
org.apache.hadoop.mapreduce.TaskTrackerInfo[]	getBlacklistedTrackers()	Get all blacklisted trackers in cluster.
org.apache.hadoop.mapreduce.QueueInfo[]	getChildQueues(java.lang.String queueName)
org.apache.hadoop.mapreduce.ClusterMetrics	getClusterMetrics()
org.apache.hadoop.security.token.Token<org.apache.hadoop.mapreduce.security.token.delegation.DelegationTokenIdentifier>	getDelegationToken(org.apache.hadoop.io.Text renewer)
java.lang.String	getFilesystemName()
org.apache.hadoop.mapreduce.Counters	getJobCounters(org.apache.hadoop.mapreduce.JobID id)
java.lang.String	getJobHistoryDir()
org.apache.hadoop.mapreduce.JobStatus	getJobStatus(org.apache.hadoop.mapreduce.JobID id)
org.apache.hadoop.mapreduce.Cluster.JobTrackerStatus	getJobTrackerStatus()
static int	getLocalMaxRunningMaps(org.apache.hadoop.mapreduce.JobContext job)
static int	getLocalMaxRunningReduces(org.apache.hadoop.mapreduce.JobContext job)
org.apache.hadoop.mapreduce.v2.LogParams	getLogFileParams(org.apache.hadoop.mapreduce.JobID jobID, org.apache.hadoop.mapreduce.TaskAttemptID taskAttemptID)
org.apache.hadoop.mapreduce.JobID	getNewJobID()
org.apache.hadoop.ipc.ProtocolSignature	getProtocolSignature(java.lang.String protocol, long clientVersion, int clientMethodsHash)
long	getProtocolVersion(java.lang.String protocol, long clientVersion)
org.apache.hadoop.mapreduce.QueueInfo	getQueue(java.lang.String queue)
org.apache.hadoop.mapreduce.QueueAclsInfo[]	getQueueAclsForCurrentUser()
org.apache.hadoop.security.authorize.AccessControlList	getQueueAdmins(java.lang.String queueName)
org.apache.hadoop.mapreduce.QueueInfo[]	getQueues()
org.apache.hadoop.mapreduce.QueueInfo[]	getRootQueues()
java.lang.String	getStagingAreaDir()
java.lang.String	getSystemDir()
org.apache.hadoop.mapreduce.TaskCompletionEvent[]	getTaskCompletionEvents(org.apache.hadoop.mapreduce.JobID jobid, int fromEventId, int maxEvents)
java.lang.String[]	getTaskDiagnostics(org.apache.hadoop.mapreduce.TaskAttemptID taskid)	Returns the diagnostic information for a particular task in the given job.
org.apache.hadoop.mapreduce.TaskReport[]	getTaskReports(org.apache.hadoop.mapreduce.JobID id, org.apache.hadoop.mapreduce.TaskType type)
long	getTaskTrackerExpiryInterval()
void	killJob(org.apache.hadoop.mapreduce.JobID id)
boolean	killTask(org.apache.hadoop.mapreduce.TaskAttemptID taskId, boolean shouldFail)	Throws UnsupportedOperationException
long	renewDelegationToken(org.apache.hadoop.security.token.Token<org.apache.hadoop.mapreduce.security.token.delegation.DelegationTokenIdentifier> token)
void	setJobPriority(org.apache.hadoop.mapreduce.JobID id, java.lang.String jp)
static void	setLocalMaxRunningMaps(org.apache.hadoop.mapreduce.JobContext job, int maxMaps)	Set the max number of map tasks to run concurrently in the LocalJobRunner.
static void	setLocalMaxRunningReduces(org.apache.hadoop.mapreduce.JobContext job, int maxReduces)	Set the max number of reduce tasks to run concurrently in the LocalJobRunner.
org.apache.hadoop.mapreduce.JobStatus	submitJob(org.apache.hadoop.mapreduce.JobID jobid, java.lang.String jobSubmitDir, org.apache.hadoop.security.Credentials credentials)

Methods inherited from class java.lang.Object

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

Field Detail

LOG

public static final org.slf4j.Logger LOG

LOCAL_MAX_MAPS

public static final java.lang.String LOCAL_MAX_MAPS

The maximum number of map tasks to run in parallel in LocalJobRunner

See Also:

Constant Field Values

LOCAL_MAX_REDUCES

public static final java.lang.String LOCAL_MAX_REDUCES

The maximum number of reduce tasks to run in parallel in LocalJobRunner

See Also:

Constant Field Values

INTERMEDIATE_DATA_ENCRYPTION_ALGO

public static final java.lang.String INTERMEDIATE_DATA_ENCRYPTION_ALGO

See Also:

Constant Field Values

Constructor Detail

LocalJobRunner

public LocalJobRunner(org.apache.hadoop.conf.Configuration conf)
               throws java.io.IOException

Throws:

java.io.IOException

LocalJobRunner

@Deprecated
public LocalJobRunner(org.apache.hadoop.mapred.JobConf conf)
               throws java.io.IOException

Deprecated.

Throws:

java.io.IOException

Method Detail

getProtocolVersion

public long getProtocolVersion(java.lang.String protocol,
                               long clientVersion)

Specified by:

getProtocolVersion in interface org.apache.hadoop.ipc.VersionedProtocol

getProtocolSignature

public org.apache.hadoop.ipc.ProtocolSignature getProtocolSignature(java.lang.String protocol,
                                                                    long clientVersion,
                                                                    int clientMethodsHash)
                                                             throws java.io.IOException

Specified by:

getProtocolSignature in interface org.apache.hadoop.ipc.VersionedProtocol

Throws:

java.io.IOException

getNewJobID

public org.apache.hadoop.mapreduce.JobID getNewJobID()

Specified by:

getNewJobID in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

submitJob

public org.apache.hadoop.mapreduce.JobStatus submitJob(org.apache.hadoop.mapreduce.JobID jobid,
                                                       java.lang.String jobSubmitDir,
                                                       org.apache.hadoop.security.Credentials credentials)
                                                throws java.io.IOException

Specified by:

submitJob in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

Throws:

java.io.IOException

killJob

public void killJob(org.apache.hadoop.mapreduce.JobID id)

Specified by:

killJob in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

setJobPriority

public void setJobPriority(org.apache.hadoop.mapreduce.JobID id,
                           java.lang.String jp)
                    throws java.io.IOException

Specified by:

setJobPriority in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

Throws:

java.io.IOException

killTask

public boolean killTask(org.apache.hadoop.mapreduce.TaskAttemptID taskId,
                        boolean shouldFail)
                 throws java.io.IOException

Throws UnsupportedOperationException

Specified by:

killTask in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

Throws:

java.io.IOException

getTaskReports

public org.apache.hadoop.mapreduce.TaskReport[] getTaskReports(org.apache.hadoop.mapreduce.JobID id,
                                                               org.apache.hadoop.mapreduce.TaskType type)

Specified by:

getTaskReports in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

getJobStatus

public org.apache.hadoop.mapreduce.JobStatus getJobStatus(org.apache.hadoop.mapreduce.JobID id)

Specified by:

getJobStatus in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

getJobCounters

public org.apache.hadoop.mapreduce.Counters getJobCounters(org.apache.hadoop.mapreduce.JobID id)

Specified by:

getJobCounters in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

getFilesystemName

public java.lang.String getFilesystemName()
                                   throws java.io.IOException

Specified by:

getFilesystemName in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

Throws:

java.io.IOException

getClusterMetrics

public org.apache.hadoop.mapreduce.ClusterMetrics getClusterMetrics()

Specified by:

getClusterMetrics in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

getJobTrackerStatus

public org.apache.hadoop.mapreduce.Cluster.JobTrackerStatus getJobTrackerStatus()

Specified by:

getJobTrackerStatus in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

getTaskTrackerExpiryInterval

public long getTaskTrackerExpiryInterval()
                                  throws java.io.IOException,
                                         java.lang.InterruptedException

Specified by:

getTaskTrackerExpiryInterval in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

Throws:

java.io.IOException

java.lang.InterruptedException

getActiveTrackers

public org.apache.hadoop.mapreduce.TaskTrackerInfo[] getActiveTrackers()
                                                                throws java.io.IOException,
                                                                       java.lang.InterruptedException

Get all active trackers in cluster.

Specified by:

getActiveTrackers in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

Returns:

array of TaskTrackerInfo

Throws:

java.io.IOException

java.lang.InterruptedException

getBlacklistedTrackers

public org.apache.hadoop.mapreduce.TaskTrackerInfo[] getBlacklistedTrackers()
                                                                     throws java.io.IOException,
                                                                            java.lang.InterruptedException

Get all blacklisted trackers in cluster.

Specified by:

getBlacklistedTrackers in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

Returns:

array of TaskTrackerInfo

Throws:

java.io.IOException

java.lang.InterruptedException

getTaskCompletionEvents

public org.apache.hadoop.mapreduce.TaskCompletionEvent[] getTaskCompletionEvents(org.apache.hadoop.mapreduce.JobID jobid,
                                                                                 int fromEventId,
                                                                                 int maxEvents)
                                                                          throws java.io.IOException

Specified by:

getTaskCompletionEvents in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

Throws:

java.io.IOException

getAllJobs

public org.apache.hadoop.mapreduce.JobStatus[] getAllJobs()

Specified by:

getAllJobs in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

getTaskDiagnostics

public java.lang.String[] getTaskDiagnostics(org.apache.hadoop.mapreduce.TaskAttemptID taskid)
                                      throws java.io.IOException

Returns the diagnostic information for a particular task in the given job. To be implemented

Specified by:

getTaskDiagnostics in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

Throws:

java.io.IOException

getSystemDir

public java.lang.String getSystemDir()

Specified by:

getSystemDir in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

See Also:

ClientProtocol.getSystemDir()

getQueueAdmins

public org.apache.hadoop.security.authorize.AccessControlList getQueueAdmins(java.lang.String queueName)
                                                                      throws java.io.IOException

Specified by:

getQueueAdmins in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

Throws:

java.io.IOException

See Also:

ClientProtocol.getQueueAdmins(String)

getStagingAreaDir

public java.lang.String getStagingAreaDir()
                                   throws java.io.IOException

Specified by:

getStagingAreaDir in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

Throws:

java.io.IOException

See Also:

ClientProtocol.getStagingAreaDir()

getJobHistoryDir

public java.lang.String getJobHistoryDir()

Specified by:

getJobHistoryDir in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

getChildQueues

public org.apache.hadoop.mapreduce.QueueInfo[] getChildQueues(java.lang.String queueName)
                                                       throws java.io.IOException

Specified by:

getChildQueues in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

Throws:

java.io.IOException

getRootQueues

public org.apache.hadoop.mapreduce.QueueInfo[] getRootQueues()
                                                      throws java.io.IOException

Specified by:

getRootQueues in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

Throws:

java.io.IOException

getQueues

public org.apache.hadoop.mapreduce.QueueInfo[] getQueues()
                                                  throws java.io.IOException

Specified by:

getQueues in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

Throws:

java.io.IOException

getQueue

public org.apache.hadoop.mapreduce.QueueInfo getQueue(java.lang.String queue)
                                               throws java.io.IOException

Specified by:

getQueue in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

Throws:

java.io.IOException

getQueueAclsForCurrentUser

public org.apache.hadoop.mapreduce.QueueAclsInfo[] getQueueAclsForCurrentUser()
                                                                       throws java.io.IOException

Specified by:

getQueueAclsForCurrentUser in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

Throws:

java.io.IOException

setLocalMaxRunningMaps

public static void setLocalMaxRunningMaps(org.apache.hadoop.mapreduce.JobContext job,
                                          int maxMaps)

Set the max number of map tasks to run concurrently in the LocalJobRunner.

Parameters:

job - the job to configure

maxMaps - the maximum number of map tasks to allow.

getLocalMaxRunningMaps

public static int getLocalMaxRunningMaps(org.apache.hadoop.mapreduce.JobContext job)

Returns:

the max number of map tasks to run concurrently in the LocalJobRunner.

setLocalMaxRunningReduces

public static void setLocalMaxRunningReduces(org.apache.hadoop.mapreduce.JobContext job,
                                             int maxReduces)

Set the max number of reduce tasks to run concurrently in the LocalJobRunner.

Parameters:

job - the job to configure

maxReduces - the maximum number of reduce tasks to allow.

getLocalMaxRunningReduces

public static int getLocalMaxRunningReduces(org.apache.hadoop.mapreduce.JobContext job)

Returns:

the max number of reduce tasks to run concurrently in the LocalJobRunner.

cancelDelegationToken

public void cancelDelegationToken(org.apache.hadoop.security.token.Token<org.apache.hadoop.mapreduce.security.token.delegation.DelegationTokenIdentifier> token)
                           throws java.io.IOException,
                                  java.lang.InterruptedException

Specified by:

cancelDelegationToken in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

Throws:

java.io.IOException

java.lang.InterruptedException

getDelegationToken

public org.apache.hadoop.security.token.Token<org.apache.hadoop.mapreduce.security.token.delegation.DelegationTokenIdentifier> getDelegationToken(org.apache.hadoop.io.Text renewer)
                                                                                                                                           throws java.io.IOException,
                                                                                                                                                  java.lang.InterruptedException

Specified by:

getDelegationToken in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

Throws:

java.io.IOException

java.lang.InterruptedException

renewDelegationToken

public long renewDelegationToken(org.apache.hadoop.security.token.Token<org.apache.hadoop.mapreduce.security.token.delegation.DelegationTokenIdentifier> token)
                          throws java.io.IOException,
                                 java.lang.InterruptedException

Specified by:

renewDelegationToken in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

Throws:

java.io.IOException

java.lang.InterruptedException

getLogFileParams

public org.apache.hadoop.mapreduce.v2.LogParams getLogFileParams(org.apache.hadoop.mapreduce.JobID jobID,
                                                                 org.apache.hadoop.mapreduce.TaskAttemptID taskAttemptID)
                                                          throws java.io.IOException,
                                                                 java.lang.InterruptedException

Specified by:

getLogFileParams in interface org.apache.hadoop.mapreduce.protocol.ClientProtocol

Throws:

java.io.IOException

java.lang.InterruptedException