mapred-queues.xml.template

<?xml version="1.0"?>
<!--
   Licensed to the Apache Software Foundation (ASF) under one or more
   contributor license agreements.  See the NOTICE file distributed with
   this work for additional information regarding copyright ownership.
   The ASF licenses this file to You under the Apache License, Version 2.0
   (the "License"); you may not use this file except in compliance with
   the License.  You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.
-->
<!-- This is the template for queue configuration. The format supports nesting of
     queues within queues - a feature called hierarchical queues. All queues are
     defined within the 'queues' tag which is the top level element for this
     XML document. The queue acls configured here for different queues are
     checked for authorization only if the configuration property
     mapreduce.cluster.acls.enabled is set to true. -->
<queues>

  <!-- Configuration for a queue is specified by defining a 'queue' element. -->
  <queue>

    <!-- Name of a queue. Queue name cannot contain a ':'  -->
    <name>default</name>

    <!-- properties for a queue, typically used by schedulers,
    can be defined here -->
    <properties>
    </properties>

	<!-- State of the queue. If running, the queue will accept new jobs.
         If stopped, the queue will not accept new jobs. -->
    <state>running</state>

    <!-- Specifies the ACLs to check for submitting jobs to this queue.
         If set to '*', it allows all users to submit jobs to the queue.
         If set to ' '(i.e. space), no user will be allowed to do this
         operation. The default value for any queue acl is ' '.
         For specifying a list of users and groups the format to use is
         user1,user2 group1,group2

         It is only used if authorization is enabled in Map/Reduce by setting
         the configuration property mapreduce.cluster.acls.enabled to true.

         Irrespective of this ACL configuration, the user who started the
         cluster and cluster administrators configured via
         mapreduce.cluster.administrators can do this operation. -->
    <acl-submit-job> </acl-submit-job>

    <!-- Specifies the ACLs to check for viewing and modifying jobs in this
         queue. Modifications include killing jobs, tasks of jobs or changing
         priorities.
         If set to '*', it allows all users to view, modify jobs of the queue.
         If set to ' '(i.e. space), no user will be allowed to do this
         operation.
         For specifying a list of users and groups the format to use is
         user1,user2 group1,group2

         It is only used if authorization is enabled in Map/Reduce by setting
         the configuration property mapreduce.cluster.acls.enabled to true.

         Irrespective of this ACL configuration, the user who started the
         cluster  and cluster administrators configured via
         mapreduce.cluster.administrators can do the above operations on all
         the jobs in all the queues. The job owner can do all the above
         operations on his/her job irrespective of this ACL configuration. -->
    <acl-administer-jobs> </acl-administer-jobs>
  </queue>

  <!-- Here is a sample of a hierarchical queue configuration
       where q2 is a child of q1. In this example, q2 is a leaf level
       queue as it has no queues configured within it. Currently, ACLs
       and state are only supported for the leaf level queues.
       Note also the usage of properties for the queue q2.
  <queue>
    <name>q1</name>
    <queue>
      <name>q2</name>
      <properties>
        <property key="capacity" value="20"/>
        <property key="user-limit" value="30"/>
      </properties>
    </queue>
  </queue>
 -->
</queues>