User Elements

User elements represent settings that govern the behavior of individual users. They can contain a single property: maxRunningApps, which limits the number of running applications for a particular user.

userMaxAppsDefault Element

The userMaxAppsDefault element sets the default running application limit for any users whose limit is not otherwise specified.

queueMaxAppsDefault Element

The queueMaxAppsDefault element sets the default running application limit for queues whenever maxRunningApps is not set for that queue.

Note: If you set a value for queueMaxAppsDefault and do not set a value for maxRunningApps for the root queue, the value of queueMaxAppsDefault sets the application limit for all queues under the root queue hierarchy.

fairSharePreemptionTimeout Element

The fairSharePreemptionTimeout element sets the number of seconds a queue is under its fair share before it tries to preempt containers to take resources from other queues.

defaultQueueSchedulingPolicy element

The defaultQueueSchedulingPolicy element sets the default scheduling policy for queues. This element is overridden by the schedulingPolicy element in each queue if it is specified. The default is fair.

queuePlacementPolicy Element

The queuePlacementPolicy element contains a list of rule elements that tell the scheduler how to place incoming applications into queues. Rules are applied in the order that they are listed. Rules can take arguments. All rules accept the create argument, which indicates whether the rule can create a new queue. The create argument defaults to true; if set to false and the rule would place the application in a queue that is not configured in the allocation file, the scheduler continues on to the next rule. The last rule must be one that can never issue a continue. Valid rules are:

  • specifiedThe application is placed into the queue it requested. If the application did not request a queue (it specified default), continue to the next rule.
  • user The application is placed into a queue with the name of the user who submitted it.
  • primaryGroup The application is placed into a queue with the name of the primary group of the user who submitted it.
  • secondaryGroupExistingQueue The application is placed into a queue with a name that matches a secondary group of the user who submitted it. The first secondary group that matches a configured queue will be selected.
  • default The application is placed into the queue named default.
  • reject The application is rejected.