forked from docs/doc-exports
Yang, Tong
5914b67d13
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com> Co-authored-by: Yang, Tong <yangtong2@huawei.com> Co-committed-by: Yang, Tong <yangtong2@huawei.com>
97 lines
15 KiB
HTML
97 lines
15 KiB
HTML
<a name="admin_guide_000112"></a><a name="admin_guide_000112"></a>
|
|
|
|
<h1 class="topictitle1">Configuring a Queue</h1>
|
|
<div id="body1529658735914"><div class="section" id="admin_guide_000112__s2276432d802d4b0a91d32ba89e2b811c"><h4 class="sectiontitle">Scenario</h4><p id="admin_guide_000112__a9088476e7671495fb539ed73c89fce73">You can modify the queue configurations for a specified tenant on <span id="admin_guide_000112__text15946118176">MRS</span> Manager.</p>
|
|
</div>
|
|
<div class="section" id="admin_guide_000112__sb828b6b939ad4208ac9c07570300c6e1"><h4 class="sectiontitle">Prerequisites</h4><p id="admin_guide_000112__p1882152461216">A tenant who uses the Superior scheduler has been added.</p>
|
|
</div>
|
|
<div class="section" id="admin_guide_000112__section95608812530"><h4 class="sectiontitle">Procedure</h4><ol id="admin_guide_000112__o6e028e09e87d4f11adbd475c0e7a0e1c"><li id="admin_guide_000112__l072b44a679534819a297e6e1758d83f2"><span>On <span id="admin_guide_000112__text1164872854712">MRS</span> Manager, choose <strong id="admin_guide_000112__b1207104105820">Tenant Resources</strong>.</span></li><li id="admin_guide_000112__l376e29e8b4c74da190a9301589e29afb"><span>Choose <strong id="admin_guide_000112__b2104909951113325">Dynamic Resource Plan</strong>.</span></li><li id="admin_guide_000112__l0c56fc34fd5149a3b4ba6a92d637fec7"><span>Click the <strong id="admin_guide_000112__b1960895051113325">Queue Configurations</strong> tab.</span></li><li id="admin_guide_000112__l88ceb9c1674945ac9decab4ed297e40e"><span>Set <strong id="admin_guide_000112__b945316511805">Cluster</strong> to the name of the target cluster. In <strong id="admin_guide_000112__b18166469112">All tenants resources</strong> area, locate the row that contains the target tenant resource and click <strong id="admin_guide_000112__b387318258211">Modify</strong> in the <strong id="admin_guide_000112__b568716234219">Operation</strong> column.</span><p><div class="note" id="admin_guide_000112__n3e080fe494fc439a8f8c4bf2ea2c9b10"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="admin_guide_000112__u919544a5ef804d25a738900f03a2d871"><li class="text" id="admin_guide_000112__l204604c3ea8a4e2882c9a66ae79b1df2">You can also access the <strong id="admin_guide_000112__b1136317117615">Modify Queue Configuration</strong> page as follows: In the tenant list on the <strong id="admin_guide_000112__b133928111648">Tenant Resources Management</strong> page, click the target tenant, click the <strong id="admin_guide_000112__b968016322411">Resource</strong> tab, and click <span><img id="admin_guide_000112__image182961122112115" src="en-us_image_0000001442494093.png"></span> next to <strong id="admin_guide_000112__b48451541342">Queue Configurations (<em id="admin_guide_000112__i87504201053">Queue name</em>)</strong>.</li><li id="admin_guide_000112__lab344dc767464c7b8ae737b6b4a2086f">A queue can be bound to only one non-default resource pool.</li><li id="admin_guide_000112__li1063311411814">For parameters such as <strong id="admin_guide_000112__b1012917346710">Max Allocated vCores</strong>, <strong id="admin_guide_000112__b1035514109818">Max Allocated Memory(MB)</strong>, <strong id="admin_guide_000112__b1711816445818"> Max Running Apps</strong>, <strong id="admin_guide_000112__b126513545816"> Max Running Apps per User</strong>, and <strong id="admin_guide_000112__b528520711911">Max Pending Apps</strong>, if the value of a sub-tenant is <strong id="admin_guide_000112__b1196112227910">-1</strong>, the value of the parent tenant can be set to a specific limit. If the parent tenant value is a specific limit, the sub-tenant value can be set to <strong id="admin_guide_000112__b21843425912">-1</strong>.</li><li id="admin_guide_000112__li86161032173811"><strong id="admin_guide_000112__b101524573119">Max Allocated vCores</strong> and <strong id="admin_guide_000112__b1673791212122">Max Allocated Memory(MB)</strong> must be both changed to values other than <strong id="admin_guide_000112__b89161725121213">-1</strong>.</li></ul>
|
|
</div></div>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="admin_guide_000112__t7e5e0a2f1ab54e63ad6515924dbf6ca5" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Queue configuration parameters</caption><thead align="left"><tr id="admin_guide_000112__r5b911308688c49a5a0b88250183ef1a7"><th align="left" class="cellrowborder" valign="top" width="30.3%" id="mcps1.3.3.2.4.2.2.2.3.1.1"><p id="admin_guide_000112__a77e68c41c8d3458e9ec15dff8b4389c9">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="69.69999999999999%" id="mcps1.3.3.2.4.2.2.2.3.1.2"><p id="admin_guide_000112__ad32d600ba56f485f897ea078dfb2a6f8">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="admin_guide_000112__r3473e147b7014e8f9696330ced934571"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.3.2.4.2.2.2.3.1.1 "><p id="admin_guide_000112__a0e071743225246a39deaa4aba748e2e2">Max Master Shares(%)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.3.2.4.2.2.2.3.1.2 "><p id="admin_guide_000112__a02167f7da7f5421cba63de63a8f06b68">Indicates the maximum percentage of resources occupied by all ApplicationMasters in the current queue.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000112__r2f7f1f0bdd6a4e869b9f3824f9d91b7c"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.3.2.4.2.2.2.3.1.1 "><p id="admin_guide_000112__a0f229be407384c179593b1b0b6c27f2f">Max Allocated vCores</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.3.2.4.2.2.2.3.1.2 "><p id="admin_guide_000112__adaae04f2aa3a4cc3bf505090199c2097">Indicates the maximum number of cores that can be allocated to a single Yarn container in the current queue. The default value is <strong id="admin_guide_000112__b2124804656113325">-1</strong>, indicating that the number of cores is not limited within the value range.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000112__r8533f3a3cd9143acb3df22f50fa0d9f2"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.3.2.4.2.2.2.3.1.1 "><p id="admin_guide_000112__aad0cdf97b8e34713acbe48752134b638">Max Allocated Memory(MB)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.3.2.4.2.2.2.3.1.2 "><p id="admin_guide_000112__ada1e159e65fb428b812a01b0f407b0ff">Indicates the maximum memory that can be allocated to a single Yarn container in the current queue. The default value is <strong id="admin_guide_000112__b1747443681113325">-1</strong>, indicating that the memory is not limited within the value range.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000112__raf34940bfa21483dbca72c23a96a5474"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.3.2.4.2.2.2.3.1.1 "><p id="admin_guide_000112__a0616caf57b554d0aa4758fe80adb8ca0">Max Running Apps</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.3.2.4.2.2.2.3.1.2 "><p id="admin_guide_000112__a2c9ace6365a54ebc9b87360dbf5b3d6a">Indicates the maximum number of tasks that can be executed at the same time in the current queue. The default value is <strong id="admin_guide_000112__b47102497179">-1</strong>, indicating that the number is not limited within the value range (the meaning is the same if the value is empty). Value <strong id="admin_guide_000112__b19507813171812">0</strong> indicates that tasks cannot be executed. The value ranges from <strong id="admin_guide_000112__b1268419270189">-1</strong> to <strong id="admin_guide_000112__b069811280184">2147483647</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000112__r144ff8351f5446dca2502f3efbe4603a"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.3.2.4.2.2.2.3.1.1 "><p id="admin_guide_000112__a73eb4faa914546148bdf3205ec5e5d84">Max Running Apps per User</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.3.2.4.2.2.2.3.1.2 "><p id="admin_guide_000112__adf6c00e17e0f4e8980796f401edf4a66">Indicates the maximum number of tasks that can be executed by each user in the current queue at the same time. The default value is <strong id="admin_guide_000112__b775978806113325">-1</strong>, indicating that the number is not limited within the value range (the meaning is the same if the value is empty). Value <strong id="admin_guide_000112__b758072381917">0</strong> indicates that tasks cannot be executed. The value ranges from <strong id="admin_guide_000112__b1061519422195">-1</strong> to <strong id="admin_guide_000112__b1061674218193">2147483647</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000112__r8f4b14705dbc4baf835d0b096b4a9c43"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.3.2.4.2.2.2.3.1.1 "><p id="admin_guide_000112__a0302cd2aaae64a938777691118efa608">Max Pending Apps</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.3.2.4.2.2.2.3.1.2 "><p id="admin_guide_000112__a85e2f6184fcc4ac4bbd789fe19c59e5d">Indicates the maximum number of tasks that can be suspended at the same time in the current queue. The default value is <strong id="admin_guide_000112__b367003997113325">-1</strong>, indicating that the number is not limited within the value range (the meaning is the same if the value is empty). Value <strong id="admin_guide_000112__b723788463113325">0</strong> indicates that tasks cannot be suspended. The value ranges from <strong id="admin_guide_000112__b6422043122015">-1</strong> to <strong id="admin_guide_000112__b15422431201">2147483647</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000112__r819ae33486d44a0da5b645edb94b10f4"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.3.2.4.2.2.2.3.1.1 "><p id="admin_guide_000112__a5d3485641a434137b9b815c4478af35f">Resource Allocation Rule</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.3.2.4.2.2.2.3.1.2 "><p id="admin_guide_000112__p178552030192113">Indicates the rule for allocating resources to different tasks of a user. The rule can be <strong id="admin_guide_000112__b10902042111">FIFO</strong> or <strong id="admin_guide_000112__b57901547218">FAIR</strong>.</p>
|
|
<p id="admin_guide_000112__a34305b328f1240a59421b7937f727cc1">If a user submits multiple tasks in the current queue and the rule is <strong id="admin_guide_000112__b3983620122112">FIFO</strong>, the tasks are executed one by one in sequential order; If the rule is <strong id="admin_guide_000112__b1190823314216">FAIR</strong>, resources are evenly allocated to all tasks.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000112__r9cfd63ef943944efab518b20b12b98ed"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.3.2.4.2.2.2.3.1.1 "><p id="admin_guide_000112__a81950623ccd54b5bbae6fb6ccb23968e">Default Resource Label</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.3.2.4.2.2.2.3.1.2 "><p id="admin_guide_000112__aaa9fab0b7bd74041a72d570d3dda9417">Indicates that tasks are executed on a node with a specified resource label.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000112__row1028912734217"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.3.2.4.2.2.2.3.1.1 "><p id="admin_guide_000112__p17522873213">Cross-Pool Scheduling</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.3.2.4.2.2.2.3.1.2 "><p id="admin_guide_000112__p1452178113219">Indicates whether containers in the current queue support cross-pool scheduling. This parameter is available for clusters of MRS 3.3.0 or later.</p>
|
|
<p id="admin_guide_000112__p69661136194412">This function cannot be enabled for the default queue.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000112__row629027194214"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.3.2.4.2.2.2.3.1.1 "><p id="admin_guide_000112__p205212811324">Cross-Pool AM Scheduling</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.3.2.4.2.2.2.3.1.2 "><p id="admin_guide_000112__p85213820322">Indicates whether ApplicationMasters in the current queue support cross-pool scheduling. This parameter is available for clusters of MRS 3.3.0 or later.</p>
|
|
<p id="admin_guide_000112__p1933625124511">This function cannot be enabled for the default queue.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000112__rb572d8a6af794ed4863c2a0ac1a32b29"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.3.2.4.2.2.2.3.1.1 "><p id="admin_guide_000112__a5f284905972241e189224c8402c0f56b">Active</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.3.2.4.2.2.2.3.1.2 "><ul id="admin_guide_000112__ul218013592217"><li id="admin_guide_000112__li51801358222"><strong id="admin_guide_000112__b922012358113325">ACTIVE</strong>: indicates that the current queue can receive and execute tasks.</li><li id="admin_guide_000112__li18180133520223"><strong id="admin_guide_000112__b1666435405113325">INACTIVE</strong>: indicates that the current queue can receive but cannot execute tasks. Tasks submitted to the queue are suspended.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000112__r7697c6a3eefd4f1ea931d27a3eb8a4a8"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.3.2.4.2.2.2.3.1.1 "><p id="admin_guide_000112__a37f0eff8e1ae4c68a0522f32015f2859">Open</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.3.2.4.2.2.2.3.1.2 "><ul id="admin_guide_000112__ul128718379229"><li id="admin_guide_000112__li128717379224"><strong id="admin_guide_000112__b970594370113325">OPEN</strong>: indicates that the current queue is opened.</li><li id="admin_guide_000112__li1287123792216"><strong id="admin_guide_000112__b704541712113325">CLOSED</strong>: indicates that the current queue is closed. Tasks submitted to the queue are rejected.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000112__row2073481315298"><td class="cellrowborder" valign="top" width="30.3%" headers="mcps1.3.3.2.4.2.2.2.3.1.1 "><p id="admin_guide_000112__p273410131292">Migrate Queue Upon Fault</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="69.69999999999999%" headers="mcps1.3.3.2.4.2.2.2.3.1.2 "><p id="admin_guide_000112__p7734141312910">If cross-AZ HA is enabled for a cluster and an AZ is faulty, set <strong id="admin_guide_000112__b568109386113325">Migrate Queue Upon Fault</strong> to <strong id="admin_guide_000112__b326680719113325">TRUE</strong> to migrate running queues of the tenant to other AZs.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</p></li><li id="admin_guide_000112__le18eed4e31af4b33b9cbc590efd74203"><span>Click <strong id="admin_guide_000112__b573620382413">OK</strong>.</span></li></ol>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="admin_guide_000108.html">Managing Resources</a></div>
|
|
</div>
|
|
</div>
|
|
|