Skip to main content

How to Stop New Hadoop MapReduce Jobs Using Queue ACLs

This article shows how to temporarily stop new Hadoop MapReduce jobs from being submitted by enabling ACLs and configuring mapred-queue-acls.xml. Existing jobs continue to run, which makes this pattern useful for maintenance windows or decommissioning work on a classic MapReduce cluster.

In a classic Hadoop MapReduce (MRv1) cluster, there are situations where you want to stop accepting new MapReduce jobs while allowing already running jobs to finish. This is especially useful during maintenance, node decommissioning or cluster reconfiguration.

One simple way to achieve this is to enable ACLs on the MapReduce job queue and then configure the submission ACL so that effectively nobody is allowed to submit new jobs.

1. Enable ACLs for MapReduce queues

First, configure queue ACLs in $HADOOP/conf/mapred-queue-acls.xml. A typical configuration might allow a set of users and groups to submit jobs and a smaller set of admins to manage them:

<configuration>
  <property>
    <name>mapred.queue.default.acl-submit-job</name>
    <value>user1,user2,group1,group2,admins</value>
  </property>

  <property>
    <name>mapred.queue.default.acl-administer-jobs</name>
    <value>admins</value>
  </property>
</configuration>

Next, enable ACL handling in the MapReduce framework by editing conf/mapred-site.xml and setting:

<property>
  <name>mapred.acls.enabled</name>
  <value>true</value>
</property>

With this in place, the MapReduce framework will enforce the ACLs defined in mapred-queue-acls.xml.

2. Temporarily block new job submissions

To block new jobs from being submitted to the default queue, you can set the submit ACL to a single space character. This is effectively an ACL that matches nobody:

<configuration>
  <property>
    <name>mapred.queue.default.acl-submit-job</name>
    <value> </value>  <!-- note: a single space -->
  </property>

  <property>
    <name>mapred.queue.default.acl-administer-jobs</name>
    <value>admins</value>
  </property>
</configuration>

Because mapred-queue-acls.xml is polled regularly by the JobTracker, these changes take effect without restarting the whole cluster. From this point on:

  • All new job submissions to the default queue are rejected due to ACLs.
  • All already running jobs continue to run until completion.

This gives operations teams a controlled way to put a cluster effectively into a “no new jobs” mode while letting current workloads drain naturally.

3. Re-enabling submissions

When maintenance is finished, simply restore the original ACLs in mapred-queue-acls.xml (for example, user1,user2,group1,group2,admins) and the cluster will start accepting new jobs again, without requiring a full restart.

Note on newer Hadoop/YARN setups

In modern YARN-based clusters with Capacity or Fair Scheduler, the same idea is implemented by adjusting queue ACLs and scheduler configuration on the ResourceManager side. The details differ, but the core pattern remains the same: restrict who can submit jobs to a queue to temporarily block new workloads while existing applications finish.

If you need help with distributed systems, backend engineering, or data platforms, check my Services.

Most read articles

Why Is Customer Obsession Disappearing?

Many companies trade real customer-obsession for automated, low-empathy support. Through examples from Coinbase, PayPal, GO Telecommunications and AT&T, this article shows how reliance on AI chatbots, outsourced call centers, and KPI-driven workflows erodes trust, NPS and customer retention. It argues that human-centric support—treating support as strategic investment instead of cost—is still a core growth engine in competitive markets. It's wild that even with all the cool tech we've got these days, like AI solving complex equations and doing business across time zones in a flash, so many companies are still struggling with the basics: taking care of their customers. The drama around Coinbase's customer support is a prime example of even tech giants messing up. And it's not just Coinbase — it's a big-picture issue for the whole industry. At some point, the idea of "customer obsession" got replaced with "customer automation," and no...

What are the performance implications of cross-platform execution within Wayang?

Apache Wayang ® enables cross-platform execution across multiple data processing platforms such as Spark, Flink, Java Streams, PostgreSQL or GraphChi. This capability fundamentally changes the performance behavior of distributed data pipelines. Wayang reduces manual data movement by selecting where each operator should run, but crossing platform boundaries still introduces serialization cost, shifts in locality, different memory strategies and new tuning constraints. Understanding these dynamics is essential before adopting Wayang for multi-platform pipelines at scale. Apache Wayang is a cross-platform data processing framework that lets developers run a single logical pipeline across engines such as Apache Spark, Apache Flink or a native Java backend. It provides an abstraction layer and a cost-based optimizer that selects the execution platform for each operator. This flexibility introduces new performance variables that do not exist in single-engine systems. Engine boundaries ...

What the Heck is Superposition and Entanglement?

This post is about superposition and interference in simple, intuitive terms. It describes how quantum states combine, how probability amplitudes add, and why interference patterns appear in systems such as electrons, photons and waves. The goal is to give a clear, non mathematical understanding of how quantum behavior emerges from the rules of wave functions and measurement. If you’ve ever heard the words superposition or entanglement thrown around in conversations about quantum physics, you may have nodded politely while your brain quietly filed them away in the "too confusing to deal with" folder.  These aren't just theoretical quirks; they're the foundation of mind-bending tech like Google's latest quantum chip, the Willow with its 105 qubits. Superposition challenges our understanding of reality, suggesting that particles don't have definite states until observed. This principle is crucial in quantum technologies, enabling phenomena like quantum comp...