mapred-site.xml (Hadoop 2.5)

mapreduce.jobtracker.jobhistory.location If job tracker is static the history files are stored in this single well known place. If No value is set here, by default, it is in the local file system at ${hadoop.log.dir}/history.
Default:
mapreduce.jobtracker.jobhistory.task.numberprogresssplits Every task attempt progresses from 0.0 to 1.0 [unless it fails or is killed]. We record, for each task attempt, certain statistics over each twelfth of the progress range. You can change the number of intervals we divide the entire range of progress into by setting this property. Higher values give more precision to the recorded data, but costs more memory in the job tracker at runtime. Each increment in this attribute costs 16 bytes per running task.
Default:12
mapreduce.job.userhistorylocation User can specify a location to store the history files of a particular job. If nothing is specified, the logs are stored in output directory. The files are stored in “_logs/history/” in the directory. User can stop logging by giving the value “none”.
Default:
mapreduce.jobtracker.jobhistory.completed.location The completed job history files are stored at this single well known location. If nothing is specified, the files are stored at ${mapreduce.jobtracker.jobhistory.location}/done.
Default:
mapreduce.job.committer.setup.cleanup.needed true, if job needs job-setup and job-cleanup. false, otherwise
Default:true
mapreduce.task.io.sort.factor The number of streams to merge at once while sorting files. This determines the number of open file handles.
Default:10
mapreduce.task.io.sort.mb The total amount of buffer memory to use while sorting files, in megabytes. By default, gives each merge stream 1MB, which should minimize seeks.
Default:100
mapreduce.map.sort.spill.percent The soft limit in the serialization buffer. Once reached, a thread will begin to spill the contents to disk in the background. Note that collection will not block if this threshold is exceeded while a spill is already in progress, so spills may be larger than this threshold when it is set to less than .5
Default:0.80
mapreduce.jobtracker.address The host and port that the MapReduce job tracker runs at. If “local”, then jobs are run in-process as a single map and reduce task.
Default:local
mapreduce.local.clientfactory.class.name This the client factory that is responsible for creating local job runner client
Default:org.apache.hadoop.mapred.LocalClientFactory
mapreduce.jobtracker.http.address The job tracker http server address and port the server will listen on. If the port is 0 then the server will start on a free port.
Default:0.0.0.0:50030
mapreduce.jobtracker.handler.count The number of server threads for the JobTracker. This should be roughly 4% of the number of tasktracker nodes.
Default:10
mapreduce.tasktracker.report.address The interface and port that task tracker server listens on. Since it is only connected to by the tasks, it uses the local interface. EXPERT ONLY. Should only be changed if your host does not have the loopback interface.
Default:127.0.0.1:0
mapreduce.cluster.local.dir The local directory where MapReduce stores intermediate data files. May be a comma-separated list of directories on different devices in order to spread disk i/o. Directories that do not exist are ignored.
Default:${hadoop.tmp.dir}/mapred/local
mapreduce.jobtracker.system.dir The directory where MapReduce stores control files.
Default:${hadoop.tmp.dir}/mapred/system
mapreduce.jobtracker.staging.root.dir The root of the staging area for users’ job files In practice, this should be the directory where users’ home directories are located (usually /user)
Default:${hadoop.tmp.dir}/mapred/staging
mapreduce.cluster.temp.dir A shared directory for temporary files.
Default:${hadoop.tmp.dir}/mapred/temp
mapreduce.tasktracker.local.dir.minspacestart If the space in mapreduce.cluster.local.dir drops under this, do not ask for more tasks. Value in bytes.
Default:0
mapreduce.tasktracker.local.dir.minspacekill If the space in mapreduce.cluster.local.dir drops under this, do not ask more tasks until all the current ones have finished and cleaned up. Also, to save the rest of the tasks we have running, kill one of them, to clean up some space. Start with the reduce tasks, then go with the ones that have finished the least. Value in bytes.
Default:0
mapreduce.jobtracker.expire.trackers.interval Expert: The time-interval, in miliseconds, after which a tasktracker is declared ‘lost’ if it doesn’t send heartbeats.
Default:600000
mapreduce.tasktracker.instrumentation Expert: The instrumentation class to associate with each TaskTracker.
Default:org.apache.hadoop.mapred.TaskTrackerMetricsInst
mapreduce.tasktracker.resourcecalculatorplugin Name of the class whose instance will be used to query resource information on the tasktracker. The class must be an instance of org.apache.hadoop.util.ResourceCalculatorPlugin. If the value is null, the tasktracker attempts to use a class appropriate to the platform. Currently, the only platform supported is Linux.
Default:
mapreduce.tasktracker.taskmemorymanager.monitoringinterval The interval, in milliseconds, for which the tasktracker waits between two cycles of monitoring its tasks’ memory usage. Used only if tasks’ memory management is enabled via mapred.tasktracker.tasks.maxmemory.
Default:5000
mapreduce.tasktracker.tasks.sleeptimebeforesigkill The time, in milliseconds, the tasktracker waits for sending a SIGKILL to a task, after it has been sent a SIGTERM. This is currently not used on WINDOWS where tasks are just sent a SIGTERM.
Default:5000
mapreduce.job.maps The default number of map tasks per job. Ignored when mapreduce.jobtracker.address is “local”.
Default:2
mapreduce.job.reduces The default number of reduce tasks per job. Typically set to 99% of the cluster’s reduce capacity, so that if a node fails the reduces can still be executed in a single wave. Ignored when mapreduce.jobtracker.address is “local”.
Default:1
mapreduce.jobtracker.restart.recover “true” to enable (job) recovery upon restart, “false” to start afresh
Default:false
mapreduce.jobtracker.jobhistory.block.size The block size of the job history file. Since the job recovery uses job history, its important to dump job history to disk as soon as possible. Note that this is an expert level parameter. The default value is set to 3 MB.
Default:3145728
mapreduce.jobtracker.taskscheduler The class responsible for scheduling the tasks.
Default:org.apache.hadoop.mapred.JobQueueTaskScheduler
mapreduce.job.reducer.preempt.delay.sec The threshold in terms of seconds after which an unsatisfied mapper request triggers reducer preemption to free space. Default 0 implies that the reduces should be preempted immediately after allocation if there is currently no room for newly allocated mappers.
Default:0
mapreduce.job.max.split.locations The max number of block locations to store for each split for locality calculation.
Default:10
mapreduce.job.split.metainfo.maxsize The maximum permissible size of the split metainfo file. The JobTracker won’t attempt to read split metainfo files bigger than the configured value. No limits if set to -1.
Default:10000000
mapreduce.jobtracker.taskscheduler.maxrunningtasks.perjob The maximum number of running tasks for a job before it gets preempted. No limits if undefined.
Default:
mapreduce.map.maxattempts Expert: The maximum number of attempts per map task. In other words, framework will try to execute a map task these many number of times before giving up on it.
Default:4
mapreduce.reduce.maxattempts Expert: The maximum number of attempts per reduce task. In other words, framework will try to execute a reduce task these many number of times before giving up on it.
Default:4
mapreduce.reduce.shuffle.retry-delay.max.ms The maximum number of ms the reducer will delay before retrying to download map data.
Default:60000
mapreduce.reduce.shuffle.parallelcopies The default number of parallel transfers run by reduce during the copy(shuffle) phase.
Default:5
mapreduce.reduce.shuffle.connect.timeout Expert: The maximum amount of time (in milli seconds) reduce task spends in trying to connect to a tasktracker for getting map output.
Default:180000
mapreduce.reduce.shuffle.read.timeout Expert: The maximum amount of time (in milli seconds) reduce task waits for map output data to be available for reading after obtaining connection.
Default:180000
mapreduce.shuffle.connection-keep-alive.enable set to true to support keep-alive connections.
Default:false
mapreduce.shuffle.connection-keep-alive.timeout The number of seconds a shuffle client attempts to retain http connection. Refer “Keep-Alive: timeout=” header in Http specification
Default:5
mapreduce.task.timeout The number of milliseconds before a task will be terminated if it neither reads an input, writes an output, nor updates its status string. A value of 0 disables the timeout.
Default:600000
mapreduce.tasktracker.map.tasks.maximum The maximum number of map tasks that will be run simultaneously by a task tracker.
Default:2
mapreduce.tasktracker.reduce.tasks.maximum The maximum number of reduce tasks that will be run simultaneously by a task tracker.
Default:2
mapreduce.jobtracker.retiredjobs.cache.size The number of retired job status to keep in the cache.
Default:1000
mapreduce.tasktracker.outofband.heartbeat Expert: Set this to true to let the tasktracker send an out-of-band heartbeat on task-completion for better latency.
Default:false
mapreduce.jobtracker.jobhistory.lru.cache.size The number of job history files loaded in memory. The jobs are loaded when they are first accessed. The cache is cleared based on LRU.
Default:5
mapreduce.jobtracker.instrumentation Expert: The instrumentation class to associate with each JobTracker.
Default:org.apache.hadoop.mapred.JobTrackerMetricsInst
mapred.child.java.opts Java opts for the task tracker child processes. The following symbol, if present, will be interpolated: @taskid@ is replaced by current TaskID. Any other occurrences of ‘@’ will go unchanged. For example, to enable verbose gc logging to a file named for the taskid in /tmp and to set the heap maximum to be a gigabyte, pass a ‘value’ of: -Xmx1024m -verbose:gc -Xloggc:/tmp/@taskid@.gc Usage of -Djava.library.path can cause programs to no longer function if hadoop native libraries are used. These values should instead be set as part of LD_LIBRARY_PATH in the map / reduce JVM env using the mapreduce.map.env and mapreduce.reduce.env config settings.
Default:-Xmx200m
mapred.child.env User added environment variables for the task tracker child processes. Example : 1) A=foo This will set the env variable A to foo 2) B=$B:c This is inherit nodemanager’s B env variable on Unix. 3) B=%B%;c This is inherit nodemanager’s B env variable on Windows.
Default:
mapreduce.admin.user.env Expert: Additional execution environment entries for map and reduce task processes. This is not an additive property. You must preserve the original value if you want your map and reduce tasks to have access to native libraries (compression, etc). When this value is empty, the command to set execution envrionment will be OS dependent: For linux, use LD_LIBRARY_PATH=$HADOOP_COMMON_HOME/lib/native. For windows, use PATH = %PATH%;%HADOOP_COMMON_HOME%\\bin.
Default:
mapreduce.task.tmp.dir To set the value of tmp directory for map and reduce tasks. If the value is an absolute path, it is directly assigned. Otherwise, it is prepended with task’s working directory. The java tasks are executed with option -Djava.io.tmpdir=’the absolute path of the tmp dir’. Pipes and streaming are set with environment variable, TMPDIR=’the absolute path of the tmp dir’
Default:./tmp
mapreduce.map.log.level The logging level for the map task. The allowed levels are: OFF, FATAL, ERROR, WARN, INFO, DEBUG, TRACE and ALL.
Default:INFO
mapreduce.reduce.log.level The logging level for the reduce task. The allowed levels are: OFF, FATAL, ERROR, WARN, INFO, DEBUG, TRACE and ALL.
Default:INFO
mapreduce.map.cpu.vcores The number of virtual cores required for each map task.
Default:1
mapreduce.reduce.cpu.vcores The number of virtual cores required for each reduce task.
Default:1
mapreduce.reduce.merge.inmem.threshold The threshold, in terms of the number of files for the in-memory merge process. When we accumulate threshold number of files we initiate the in-memory merge and spill to disk. A value of 0 or less than 0 indicates we want to DON’T have any threshold and instead depend only on the ramfs’s memory consumption to trigger the merge.
Default:1000
mapreduce.reduce.shuffle.merge.percent The usage threshold at which an in-memory merge will be initiated, expressed as a percentage of the total memory allocated to storing in-memory map outputs, as defined by mapreduce.reduce.shuffle.input.buffer.percent.
Default:0.66
mapreduce.reduce.shuffle.input.buffer.percent The percentage of memory to be allocated from the maximum heap size to storing map outputs during the shuffle.
Default:0.70
mapreduce.reduce.input.buffer.percent The percentage of memory- relative to the maximum heap size- to retain map outputs during the reduce. When the shuffle is concluded, any remaining map outputs in memory must consume less than this threshold before the reduce can begin.
Default:0.0
mapreduce.reduce.shuffle.memory.limit.percent Expert: Maximum percentage of the in-memory limit that a single shuffle can consume
Default:0.25
mapreduce.shuffle.ssl.enabled Whether to use SSL for for the Shuffle HTTP endpoints.
Default:false
mapreduce.shuffle.ssl.file.buffer.size Buffer size for reading spills from file when using SSL.
Default:65536
mapreduce.shuffle.max.connections Max allowed connections for the shuffle. Set to 0 (zero) to indicate no limit on the number of connections.
Default:0
mapreduce.shuffle.max.threads Max allowed threads for serving shuffle connections. Set to zero to indicate the default of 2 times the number of available processors (as reported by Runtime.availableProcessors()). Netty is used to serve requests, so a thread is not needed for each connection.
Default:0
mapreduce.shuffle.transferTo.allowed This option can enable/disable using nio transferTo method in the shuffle phase. NIO transferTo does not perform well on windows in the shuffle phase. Thus, with this configuration property it is possible to disable it, in which case custom transfer method will be used. Recommended value is false when running Hadoop on Windows. For Linux, it is recommended to set it to true. If nothing is set then the default value is false for Windows, and true for Linux.
Default:
mapreduce.shuffle.transfer.buffer.size This property is used only if mapreduce.shuffle.transferTo.allowed is set to false. In that case, this property defines the size of the buffer used in the buffer copy code for the shuffle phase. The size of this buffer determines the size of the IO requests.
Default:131072
mapreduce.reduce.markreset.buffer.percent The percentage of memory -relative to the maximum heap size- to be used for caching values when using the mark-reset functionality.
Default:0.0
mapreduce.map.speculative If true, then multiple instances of some map tasks may be executed in parallel.
Default:true
mapreduce.reduce.speculative If true, then multiple instances of some reduce tasks may be executed in parallel.
Default:true
mapreduce.job.speculative.speculativecap The max percent (0-1) of running tasks that can be speculatively re-executed at any time.
Default:0.1
mapreduce.job.map.output.collector.class It defines the MapOutputCollector implementation to use.
Default:org.apache.hadoop.mapred.MapTask$MapOutputBuffer
mapreduce.job.speculative.slowtaskthreshold
Default:1.0
mapreduce.job.speculative.slownodethreshold The number of standard deviations by which a Task Tracker’s ave map and reduce progress-rates (finishTime-dispatchTime) must be lower than the average of all successful map/reduce task’s for the TT to be considered too slow to give a speculative task to.
Default:1.0
mapreduce.job.jvm.numtasks How many tasks to run per jvm. If set to -1, there is no limit.
Default:1
mapreduce.job.ubertask.enable Whether to enable the small-jobs “ubertask” optimization, which runs “sufficiently small” jobs sequentially within a single JVM. “Small” is defined by the following maxmaps, maxreduces, and maxbytes settings. Users may override this value.
Default:false
mapreduce.job.ubertask.maxmaps Threshold for number of maps, beyond which job is considered too big for the ubertasking optimization. Users may override this value, but only downward.
Default:9
mapreduce.job.ubertask.maxreduces Threshold for number of reduces, beyond which job is considered too big for the ubertasking optimization. CURRENTLY THE CODE CANNOT SUPPORT MORE THAN ONE REDUCE and will ignore larger values. (Zero is a valid max, however.) Users may override this value, but only downward.
Default:1
mapreduce.job.ubertask.maxbytes Threshold for number of input bytes, beyond which job is considered too big for the ubertasking optimization. If no value is specified, dfs.block.size is used as a default. Be sure to specify a default value in mapred-site.xml if the underlying filesystem is not HDFS. Users may override this value, but only downward.
Default:
mapreduce.input.fileinputformat.split.minsize The minimum size chunk that map input should be split into. Note that some file formats may have minimum split sizes that take priority over this setting.
Default:0
mapreduce.input.fileinputformat.list-status.num-threads The number of threads to use to list and fetch block locations for the specified input paths. Note: multiple threads should not be used if a custom non thread-safe path filter is used.
Default:1
mapreduce.jobtracker.maxtasks.perjob The maximum number of tasks for a single job. A value of -1 indicates that there is no maximum.
Default:-1
mapreduce.client.submit.file.replication The replication level for submitted job files. This should be around the square root of the number of nodes.
Default:10
mapreduce.tasktracker.dns.interface The name of the Network Interface from which a task tracker should report its IP address.
Default:default
mapreduce.tasktracker.dns.nameserver The host name or IP address of the name server (DNS) which a TaskTracker should use to determine the host name used by the JobTracker for communication and display purposes.
Default:default
mapreduce.tasktracker.http.threads The number of worker threads that for the http server. This is used for map output fetching
Default:40
mapreduce.tasktracker.http.address The task tracker http server address and port. If the port is 0 then the server will start on a free port.
Default:0.0.0.0:50060
mapreduce.task.files.preserve.failedtasks Should the files for failed tasks be kept. This should only be used on jobs that are failing, because the storage is never reclaimed. It also prevents the map outputs from being erased from the reduce directory as they are consumed.
Default:false
mapreduce.output.fileoutputformat.compress Should the job outputs be compressed?
Default:false
mapreduce.output.fileoutputformat.compress.type If the job outputs are to compressed as SequenceFiles, how should they be compressed? Should be one of NONE, RECORD or BLOCK.
Default:RECORD
mapreduce.output.fileoutputformat.compress.codec If the job outputs are compressed, how should they be compressed?
Default:org.apache.hadoop.io.compress.DefaultCodec
mapreduce.map.output.compress Should the outputs of the maps be compressed before being sent across the network. Uses SequenceFile compression.
Default:false
mapreduce.map.output.compress.codec If the map outputs are compressed, how should they be compressed?
Default:org.apache.hadoop.io.compress.DefaultCodec
map.sort.class The default sort class for sorting keys.
Default:org.apache.hadoop.util.QuickSort
mapreduce.task.userlog.limit.kb The maximum size of user-logs of each task in KB. 0 disables the cap.
Default:0
yarn.app.mapreduce.am.container.log.limit.kb The maximum size of the MRAppMaster attempt container logs in KB. 0 disables the cap.
Default:0
yarn.app.mapreduce.task.container.log.backups Number of backup files for task logs when using ContainerRollingLogAppender (CRLA). See org.apache.log4j.RollingFileAppender.maxBackupIndex. By default, ContainerLogAppender (CLA) is used, and container logs are not rolled. CRLA is enabled for tasks when both mapreduce.task.userlog.limit.kb and yarn.app.mapreduce.task.container.log.backups are greater than zero.
Default:0
yarn.app.mapreduce.am.container.log.backups Number of backup files for the ApplicationMaster logs when using ContainerRollingLogAppender (CRLA). See org.apache.log4j.RollingFileAppender.maxBackupIndex. By default, ContainerLogAppender (CLA) is used, and container logs are not rolled. CRLA is enabled for the ApplicationMaster when both mapreduce.task.userlog.limit.kb and yarn.app.mapreduce.am.container.log.backups are greater than zero.
Default:0
mapreduce.job.userlog.retain.hours The maximum time, in hours, for which the user-logs are to be retained after the job completion.
Default:24
mapreduce.jobtracker.hosts.filename Names a file that contains the list of nodes that may connect to the jobtracker. If the value is empty, all hosts are permitted.
Default:
mapreduce.jobtracker.hosts.exclude.filename Names a file that contains the list of hosts that should be excluded by the jobtracker. If the value is empty, no hosts are excluded.
Default:
mapreduce.jobtracker.heartbeats.in.second Expert: Approximate number of heart-beats that could arrive at JobTracker in a second. Assuming each RPC can be processed in 10msec, the default value is made 100 RPCs in a second.
Default:100
mapreduce.jobtracker.tasktracker.maxblacklists The number of blacklists for a taskTracker by various jobs after which the task tracker could be blacklisted across all jobs. The tracker will be given a tasks later (after a day). The tracker will become a healthy tracker after a restart.
Default:4
mapreduce.job.maxtaskfailures.per.tracker The number of task-failures on a tasktracker of a given job after which new tasks of that job aren’t assigned to it. It MUST be less than mapreduce.map.maxattempts and mapreduce.reduce.maxattempts otherwise the failed task will never be tried on a different node.
Default:3
mapreduce.client.output.filter The filter for controlling the output of the task’s userlogs sent to the console of the JobClient. The permissible options are: NONE, KILLED, FAILED, SUCCEEDED and ALL.
Default:FAILED
mapreduce.client.completion.pollinterval The interval (in milliseconds) between which the JobClient polls the JobTracker for updates about job status. You may want to set this to a lower value to make tests run faster on a single node system. Adjusting this value in production may lead to unwanted client-server traffic.
Default:5000
mapreduce.client.progressmonitor.pollinterval The interval (in milliseconds) between which the JobClient reports status to the console and checks for job completion. You may want to set this to a lower value to make tests run faster on a single node system. Adjusting this value in production may lead to unwanted client-server traffic.
Default:1000
mapreduce.jobtracker.persist.jobstatus.active Indicates if persistency of job status information is active or not.
Default:true
mapreduce.jobtracker.persist.jobstatus.hours The number of hours job status information is persisted in DFS. The job status information will be available after it drops of the memory queue and between jobtracker restarts. With a zero value the job status information is not persisted at all in DFS.
Default:1
mapreduce.jobtracker.persist.jobstatus.dir The directory where the job status information is persisted in a file system to be available after it drops of the memory queue and between jobtracker restarts.
Default:/jobtracker/jobsInfo
mapreduce.task.profile To set whether the system should collect profiler information for some of the tasks in this job? The information is stored in the user log directory. The value is “true” if task profiling is enabled.
Default:false
mapreduce.task.profile.maps To set the ranges of map tasks to profile. mapreduce.task.profile has to be set to true for the value to be accounted.
Default:0-2
mapreduce.task.profile.reduces To set the ranges of reduce tasks to profile. mapreduce.task.profile has to be set to true for the value to be accounted.
Default:0-2
mapreduce.task.profile.params JVM profiler parameters used to profile map and reduce task attempts. This string may contain a single format specifier %s that will be replaced by the path to profile.out in the task attempt log directory. To specify different profiling options for map tasks and reduce tasks, more specific parameters mapreduce.task.profile.map.params and mapreduce.task.profile.reduce.params should be used.
Default:-agentlib:hprof=cpu=samples,heap=sites,force=n,thread=y,verbose=n,file=%s
mapreduce.task.profile.map.params Map-task-specific JVM profiler parameters. See mapreduce.task.profile.params
Default:${mapreduce.task.profile.params}
mapreduce.task.profile.reduce.params Reduce-task-specific JVM profiler parameters. See mapreduce.task.profile.params
Default:${mapreduce.task.profile.params}
mapreduce.task.skip.start.attempts The number of Task attempts AFTER which skip mode will be kicked off. When skip mode is kicked off, the tasks reports the range of records which it will process next, to the TaskTracker. So that on failures, TT knows which ones are possibly the bad records. On further executions, those are skipped.
Default:2
mapreduce.map.skip.proc.count.autoincr The flag which if set to true, SkipBadRecords.COUNTER_MAP_PROCESSED_RECORDS is incremented by MapRunner after invoking the map function. This value must be set to false for applications which process the records asynchronously or buffer the input records. For example streaming. In such cases applications should increment this counter on their own.
Default:true
mapreduce.reduce.skip.proc.count.autoincr The flag which if set to true, SkipBadRecords.COUNTER_REDUCE_PROCESSED_GROUPS is incremented by framework after invoking the reduce function. This value must be set to false for applications which process the records asynchronously or buffer the input records. For example streaming. In such cases applications should increment this counter on their own.
Default:true
mapreduce.job.skip.outdir If no value is specified here, the skipped records are written to the output directory at _logs/skip. User can stop writing skipped records by giving the value “none”.
Default:
mapreduce.map.skip.maxrecords The number of acceptable skip records surrounding the bad record PER bad record in mapper. The number includes the bad record as well. To turn the feature of detection/skipping of bad records off, set the value to 0. The framework tries to narrow down the skipped range by retrying until this threshold is met OR all attempts get exhausted for this task. Set the value to Long.MAX_VALUE to indicate that framework need not try to narrow down. Whatever records(depends on application) get skipped are acceptable.
Default:0
mapreduce.reduce.skip.maxgroups The number of acceptable skip groups surrounding the bad group PER bad group in reducer. The number includes the bad group as well. To turn the feature of detection/skipping of bad groups off, set the value to 0. The framework tries to narrow down the skipped range by retrying until this threshold is met OR all attempts get exhausted for this task. Set the value to Long.MAX_VALUE to indicate that framework need not try to narrow down. Whatever groups(depends on application) get skipped are acceptable.
Default:0
mapreduce.ifile.readahead Configuration key to enable/disable IFile readahead.
Default:true
mapreduce.ifile.readahead.bytes Configuration key to set the IFile readahead length in bytes.
Default:4194304
mapreduce.jobtracker.taskcache.levels This is the max level of the task cache. For example, if the level is 2, the tasks cached are at the host level and at the rack level.
Default:2
mapreduce.job.queuename Queue to which a job is submitted. This must match one of the queues defined in mapred-queues.xml for the system. Also, the ACL setup for the queue must allow the current user to submit a job to the queue. Before specifying a queue, ensure that the system is configured with the queue, and access is allowed for submitting jobs to the queue.
Default:default
mapreduce.job.tags Tags for the job that will be passed to YARN at submission time. Queries to YARN for applications can filter on these tags.
Default:
mapreduce.cluster.acls.enabled Specifies whether ACLs should be checked for authorization of users for doing various queue and job level operations. ACLs are disabled by default. If enabled, access control checks are made by JobTracker and TaskTracker when requests are made by users for queue operations like submit job to a queue and kill a job in the queue and job operations like viewing the job-details (See mapreduce.job.acl-view-job) or for modifying the job (See mapreduce.job.acl-modify-job) using Map/Reduce APIs, RPCs or via the console and web user interfaces. For enabling this flag(mapreduce.cluster.acls.enabled), this is to be set to true in mapred-site.xml on JobTracker node and on all TaskTracker nodes.
Default:false
mapreduce.job.acl-modify-job Job specific access-control list for ‘modifying’ the job. It is only used if authorization is enabled in Map/Reduce by setting the configuration property mapreduce.cluster.acls.enabled to true. This specifies the list of users and/or groups who can do modification operations on the job. For specifying a list of users and groups the format to use is “user1,user2 group1,group”. If set to ‘*’, it allows all users/groups to modify this job. If set to ‘ ‘(i.e. space), it allows none. This configuration is used to guard all the modifications with respect to this job and takes care of all the following operations: o killing this job o killing a task of this job, failing a task of this job o setting the priority of this job Each of these operations are also protected by the per-queue level ACL “acl-administer-jobs” configured via mapred-queues.xml. So a caller should have the authorization to satisfy either the queue-level ACL or the job-level ACL. Irrespective of this ACL configuration, (a) job-owner, (b) the user who started the cluster, (c) members of an admin configured supergroup configured via mapreduce.cluster.permissions.supergroup and (d) queue administrators of the queue to which this job was submitted to configured via acl-administer-jobs for the specific queue in mapred-queues.xml can do all the modification operations on a job. By default, nobody else besides job-owner, the user who started the cluster, members of supergroup and queue administrators can perform modification operations on a job.
Default:
mapreduce.job.acl-view-job Job specific access-control list for ‘viewing’ the job. It is only used if authorization is enabled in Map/Reduce by setting the configuration property mapreduce.cluster.acls.enabled to true. This specifies the list of users and/or groups who can view private details about the job. For specifying a list of users and groups the format to use is “user1,user2 group1,group”. If set to ‘*’, it allows all users/groups to modify this job. If set to ‘ ‘(i.e. space), it allows none. This configuration is used to guard some of the job-views and at present only protects APIs that can return possibly sensitive information of the job-owner like o job-level counters o task-level counters o tasks’ diagnostic information o task-logs displayed on the TaskTracker web-UI and o job.xml showed by the JobTracker’s web-UI Every other piece of information of jobs is still accessible by any other user, for e.g., JobStatus, JobProfile, list of jobs in the queue, etc. Irrespective of this ACL configuration, (a) job-owner, (b) the user who started the cluster, (c) members of an admin configured supergroup configured via mapreduce.cluster.permissions.supergroup and (d) queue administrators of the queue to which this job was submitted to configured via acl-administer-jobs for the specific queue in mapred-queues.xml can do all the view operations on a job. By default, nobody else besides job-owner, the user who started the cluster, memebers of supergroup and queue administrators can perform view operations on a job.
Default:
mapreduce.tasktracker.indexcache.mb The maximum memory that a task tracker allows for the index cache that is used when serving map outputs to reducers.
Default:10
mapreduce.job.token.tracking.ids.enabled Whether to write tracking ids of tokens to job-conf. When true, the configuration property “mapreduce.job.token.tracking.ids” is set to the token-tracking-ids of the job
Default:false
mapreduce.job.token.tracking.ids When mapreduce.job.token.tracking.ids.enabled is set to true, this is set by the framework to the token-tracking-ids used by the job.
Default:
mapreduce.task.merge.progress.records The number of records to process during merge before sending a progress notification to the TaskTracker.
Default:10000
mapreduce.job.reduce.slowstart.completedmaps Fraction of the number of maps in the job which should be complete before reduces are scheduled for the job.
Default:0.05
mapreduce.job.complete.cancel.delegation.tokens if false – do not unregister/cancel delegation tokens from renewal, because same tokens may be used by spawned jobs
Default:true
mapreduce.tasktracker.taskcontroller TaskController which is used to launch and manage task execution
Default:org.apache.hadoop.mapred.DefaultTaskController
mapreduce.tasktracker.group Expert: Group to which TaskTracker belongs. If LinuxTaskController is configured via mapreduce.tasktracker.taskcontroller, the group owner of the task-controller binary should be same as this group.
Default:
mapreduce.shuffle.port Default port that the ShuffleHandler will run on. ShuffleHandler is a service run at the NodeManager to facilitate transfers of intermediate Map outputs to requesting Reducers.
Default:13562
mapreduce.job.reduce.shuffle.consumer.plugin.class Name of the class whose instance will be used to send shuffle requests by reducetasks of this job. The class must be an instance of org.apache.hadoop.mapred.ShuffleConsumerPlugin.
Default:org.apache.hadoop.mapreduce.task.reduce.Shuffle
mapreduce.tasktracker.healthchecker.script.path Absolute path to the script which is periodicallyrun by the node health monitoring service to determine if the node is healthy or not. If the value of this key is empty or the file does not exist in the location configured here, the node health monitoring service is not started.
Default:
mapreduce.tasktracker.healthchecker.interval Frequency of the node health script to be run, in milliseconds
Default:60000
mapreduce.tasktracker.healthchecker.script.timeout Time after node health script should be killed if unresponsive and considered that the script has failed.
Default:600000
mapreduce.tasktracker.healthchecker.script.args List of arguments which are to be passed to node health script when it is being launched comma seperated.
Default:
mapreduce.job.counters.limit Limit on the number of user counters allowed per job.
Default:120
mapreduce.framework.name The runtime framework for executing MapReduce jobs. Can be one of local, classic or yarn.
Default:local
yarn.app.mapreduce.am.staging-dir The staging dir used while submitting jobs.
Default:/tmp/hadoop-yarn/staging
mapreduce.am.max-attempts The maximum number of application attempts. It is a application-specific setting. It should not be larger than the global number set by resourcemanager. Otherwise, it will be override. The default number is set to 2, to allow at least one retry for AM.
Default:2
mapreduce.job.end-notification.url Indicates url which will be called on completion of job to inform end status of job. User can give at most 2 variables with URI : $jobId and $jobStatus. If they are present in URI, then they will be replaced by their respective values.
Default:
mapreduce.job.end-notification.retry.attempts The number of times the submitter of the job wants to retry job end notification if it fails. This is capped by mapreduce.job.end-notification.max.attempts
Default:0
mapreduce.job.end-notification.retry.interval The number of milliseconds the submitter of the job wants to wait before job end notification is retried if it fails. This is capped by mapreduce.job.end-notification.max.retry.interval
Default:1000
mapreduce.job.end-notification.max.attempts The maximum number of times a URL will be read for providing job end notification. Cluster administrators can set this to limit how long after end of a job, the Application Master waits before exiting. Must be marked as final to prevent users from overriding this.
Default:5
mapreduce.job.end-notification.max.retry.interval The maximum amount of time (in milliseconds) to wait before retrying job end notification. Cluster administrators can set this to limit how long the Application Master waits before exiting. Must be marked as final to prevent users from overriding this.
Default:5000
yarn.app.mapreduce.am.env User added environment variables for the MR App Master processes. Example : 1) A=foo This will set the env variable A to foo 2) B=$B:c This is inherit tasktracker’s B env variable.
Default:
yarn.app.mapreduce.am.admin.user.env Environment variables for the MR App Master processes for admin purposes. These values are set first and can be overridden by the user env (yarn.app.mapreduce.am.env) Example : 1) A=foo This will set the env variable A to foo 2) B=$B:c This is inherit app master’s B env variable.
Default:
yarn.app.mapreduce.am.command-opts Java opts for the MR App Master processes. The following symbol, if present, will be interpolated: @taskid@ is replaced by current TaskID. Any other occurrences of ‘@’ will go unchanged. For example, to enable verbose gc logging to a file named for the taskid in /tmp and to set the heap maximum to be a gigabyte, pass a ‘value’ of: -Xmx1024m -verbose:gc -Xloggc:/tmp/@taskid@.gc Usage of -Djava.library.path can cause programs to no longer function if hadoop native libraries are used. These values should instead be set as part of LD_LIBRARY_PATH in the map / reduce JVM env using the mapreduce.map.env and mapreduce.reduce.env config settings.
Default:-Xmx1024m
yarn.app.mapreduce.am.admin-command-opts Java opts for the MR App Master processes for admin purposes. It will appears before the opts set by yarn.app.mapreduce.am.command-opts and thus its options can be overridden user. Usage of -Djava.library.path can cause programs to no longer function if hadoop native libraries are used. These values should instead be set as part of LD_LIBRARY_PATH in the map / reduce JVM env using the mapreduce.map.env and mapreduce.reduce.env config settings.
Default:
yarn.app.mapreduce.am.job.task.listener.thread-count The number of threads used to handle RPC calls in the MR AppMaster from remote tasks
Default:30
yarn.app.mapreduce.am.job.client.port-range Range of ports that the MapReduce AM can use when binding. Leave blank if you want all possible ports. For example 50000-50050,50100-50200
Default:
yarn.app.mapreduce.am.job.committer.cancel-timeout The amount of time in milliseconds to wait for the output committer to cancel an operation if the job is killed
Default:60000
yarn.app.mapreduce.am.job.committer.commit-window Defines a time window in milliseconds for output commit operations. If contact with the RM has occurred within this window then commits are allowed, otherwise the AM will not allow output commits until contact with the RM has been re-established.
Default:10000
yarn.app.mapreduce.am.scheduler.heartbeat.interval-ms The interval in ms at which the MR AppMaster should send heartbeats to the ResourceManager
Default:1000
yarn.app.mapreduce.client-am.ipc.max-retries The number of client retries to the AM – before reconnecting to the RM to fetch Application Status.
Default:3
yarn.app.mapreduce.client-am.ipc.max-retries-on-timeouts The number of client retries on socket timeouts to the AM – before reconnecting to the RM to fetch Application Status.
Default:3
yarn.app.mapreduce.client.max-retries The number of client retries to the RM/HS before throwing exception. This is a layer above the ipc.
Default:3
yarn.app.mapreduce.am.resource.mb The amount of memory the MR AppMaster needs.
Default:1536
yarn.app.mapreduce.am.resource.cpu-vcores The number of virtual CPU cores the MR AppMaster needs.
Default:1
mapreduce.application.classpath CLASSPATH for MR applications. A comma-separated list of CLASSPATH entries. If mapreduce.application.framework is set then this must specify the appropriate classpath for that archive, and the name of the archive must be present in the classpath. If mapreduce.app-submission.cross-platform is false, platform-specific environment vairable expansion syntax would be used to construct the default CLASSPATH entries. For Linux: $HADOOP_MAPRED_HOME/share/hadoop/mapreduce/*, $HADOOP_MAPRED_HOME/share/hadoop/mapreduce/lib/*. For Windows: %HADOOP_MAPRED_HOME%/share/hadoop/mapreduce/*, %HADOOP_MAPRED_HOME%/share/hadoop/mapreduce/lib/*. If mapreduce.app-submission.cross-platform is true, platform-agnostic default CLASSPATH for MR applications would be used: {{HADOOP_MAPRED_HOME}}/share/hadoop/mapreduce/*, {{HADOOP_MAPRED_HOME}}/share/hadoop/mapreduce/lib/* Parameter expansion marker will be replaced by NodeManager on container launch based on the underlying OS accordingly.
Default:
mapreduce.app-submission.cross-platform If enabled, user can submit an application cross-platform i.e. submit an application from a Windows client to a Linux/Unix server or vice versa.
Default:false
mapreduce.application.framework.path Path to the MapReduce framework archive. If set, the framework archive will automatically be distributed along with the job, and this path would normally reside in a public location in an HDFS filesystem. As with distributed cache files, this can be a URL with a fragment specifying the alias to use for the archive name. For example, hdfs:/mapred/framework/hadoop-mapreduce-2.1.1.tar.gz#mrframework would alias the localized archive as “mrframework”. Note that mapreduce.application.classpath must include the appropriate classpath for the specified framework. The base name of the archive, or alias of the archive if an alias is used, must appear in the specified classpath.
Default:
mapreduce.job.classloader Whether to use a separate (isolated) classloader for user classes in the task JVM.
Default:false
mapreduce.job.classloader.system.classes A comma-separated list of classes that should be loaded from the system classpath, not the user-supplied JARs, when mapreduce.job.classloader is enabled. Names ending in ‘.’ (period) are treated as package names, and names starting with a ‘-‘ are treated as negative matches.
Default:java.,javax.,org.apache.commons.logging.,org.apache.log4j.,
org.apache.hadoop.,core-default.xml,hdfs-default.xml,
mapred-default.xml,yarn-default.xml
mapreduce.jobhistory.address MapReduce JobHistory Server IPC host:port
Default:0.0.0.0:10020
mapreduce.jobhistory.webapp.address MapReduce JobHistory Server Web UI host:port
Default:0.0.0.0:19888
mapreduce.jobhistory.keytab Location of the kerberos keytab file for the MapReduce JobHistory Server.
Default:/etc/security/keytab/jhs.service.keytab
mapreduce.jobhistory.principal Kerberos principal name for the MapReduce JobHistory Server.
Default:jhs/_HOST@REALM.TLD
mapreduce.jobhistory.intermediate-done-dir
Default:${yarn.app.mapreduce.am.staging-dir}/history/done_intermediate
mapreduce.jobhistory.done-dir
Default:${yarn.app.mapreduce.am.staging-dir}/history/done
mapreduce.jobhistory.cleaner.enable
Default:true
mapreduce.jobhistory.cleaner.interval-ms How often the job history cleaner checks for files to delete, in milliseconds. Defaults to 86400000 (one day). Files are only deleted if they are older than mapreduce.jobhistory.max-age-ms.
Default:86400000
mapreduce.jobhistory.max-age-ms Job history files older than this many milliseconds will be deleted when the history cleaner runs. Defaults to 604800000 (1 week).
Default:604800000
mapreduce.jobhistory.client.thread-count The number of threads to handle client API requests
Default:10
mapreduce.jobhistory.datestring.cache.size Size of the date string cache. Effects the number of directories which will be scanned to find a job.
Default:200000
mapreduce.jobhistory.joblist.cache.size Size of the job list cache
Default:20000
mapreduce.jobhistory.loadedjobs.cache.size Size of the loaded job cache
Default:5
mapreduce.jobhistory.move.interval-ms Scan for history files to more from intermediate done dir to done dir at this frequency.
Default:180000
mapreduce.jobhistory.move.thread-count The number of threads used to move files.
Default:3
mapreduce.jobhistory.store.class The HistoryStorage class to use to cache history data.
Default:
mapreduce.jobhistory.minicluster.fixed.ports Whether to use fixed ports with the minicluster
Default:false
mapreduce.jobhistory.admin.address The address of the History server admin interface.
Default:0.0.0.0:10033
mapreduce.jobhistory.admin.acl ACL of who can be admin of the History server.
Default:*
mapreduce.jobhistory.recovery.enable Enable the history server to store server state and recover server state upon startup. If enabled then mapreduce.jobhistory.recovery.store.class must be specified.
Default:false
mapreduce.jobhistory.recovery.store.class The HistoryServerStateStoreService class to store history server state for recovery.
Default:org.apache.hadoop.mapreduce.v2.hs.HistoryServerFileSystemStateStoreService
mapreduce.jobhistory.recovery.store.fs.uri The URI where history server state will be stored if HistoryServerFileSystemStateStoreService is configured as the recovery storage class.
Default:${hadoop.tmp.dir}/mapred/history/recoverystore
mapreduce.jobhistory.http.policy This configures the HTTP endpoint for JobHistoryServer web UI. The following values are supported: – HTTP_ONLY : Service is provided only on http – HTTPS_ONLY : Service is provided only on https
Default:HTTP_ONLY

Leave a comment