forked from docs/doc-exports
Yang, Tong
2195db241c
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com> Reviewed-by: Rechenburg, Matthias <matthias.rechenburg@t-systems.com> Co-authored-by: Yang, Tong <yangtong2@huawei.com> Co-committed-by: Yang, Tong <yangtong2@huawei.com>
102 lines
19 KiB
HTML
102 lines
19 KiB
HTML
<a name="admin_guide_000119"></a><a name="admin_guide_000119"></a>
|
|
|
|
<h1 class="topictitle1">Adding a Sub-Tenant</h1>
|
|
<div id="body1529658735913"><div class="section" id="admin_guide_000119__s3ed8de41c9dc4d6f8b3bb3d1c2282827"><h4 class="sectiontitle">Scenario</h4><p id="admin_guide_000119__p173871710351">You can create sub-tenants on <span id="admin_guide_000119__text15946118176">MRS</span> Manager and allocate resources of the current tenant to the sub-tenants based on the resource consumption and isolation planning and requirements of services.</p>
|
|
</div>
|
|
<div class="section" id="admin_guide_000119__sdb988972da6b4812bcf0e6e83eff6290"><h4 class="sectiontitle">Prerequisites</h4><ul id="admin_guide_000119__u7744938b03e045e08f51af7b4c3b24fa"><li id="admin_guide_000119__l8a6e0af6d28f4845b4588935283bb303">A parent non-leaf tenant has been added.</li><li id="admin_guide_000119__l3913ac289d3e4fc58400b4af5ed34de7">A tenant name has been planned based on service requirements. The name cannot be the same as that of a role, HDFS directory, or Yarn queue that exists in the current cluster.</li><li id="admin_guide_000119__l8ef3b4332c374932b89e53dd1a14a2c0">Resources to be allocated to the current tenant have been planned to ensure that the sum of resources of direct sub-tenants at each level does not exceed the resources of the current tenant.</li></ul>
|
|
</div>
|
|
<div class="section" id="admin_guide_000119__section1645135719413"><h4 class="sectiontitle">Procedure</h4><ol id="admin_guide_000119__o84db0c77dffc41b7b76134fb1d861481"><li id="admin_guide_000119__lb50c3ad58b0d46299441c786ce7bd97c"><span>Log in to <span id="admin_guide_000119__text83327894817">MRS</span> Manager and choose <strong id="admin_guide_000119__b73231244133715">Tenant Resources</strong>.</span></li><li id="admin_guide_000119__l88426277118a4eb6bb0f49043413936e"><span>In the tenant list on the left, select a parent tenant and click <span><img id="admin_guide_000119__image175712254719" src="en-us_image_0000001442653665.png"></span>. On the page for adding a sub-tenant, set attributes for the sub-tenant according to <a href="#admin_guide_000119__tc983b52ccd084798871c7fa2b49856dd">Table 1</a>.</span><p>
|
|
<div class="tablenoborder"><a name="admin_guide_000119__tc983b52ccd084798871c7fa2b49856dd"></a><a name="tc983b52ccd084798871c7fa2b49856dd"></a><table cellpadding="4" cellspacing="0" summary="" id="admin_guide_000119__tc983b52ccd084798871c7fa2b49856dd" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Sub-tenant parameters</caption><thead align="left"><tr id="admin_guide_000119__rabbebe5b7e1c4d6a99cfd4e5bee2e89e"><th align="left" class="cellrowborder" valign="top" width="32.32%" id="mcps1.3.3.2.2.2.1.2.3.1.1"><p id="admin_guide_000119__af842cb1dac1348379cd6db000d3a7699">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="67.67999999999999%" id="mcps1.3.3.2.2.2.1.2.3.1.2"><p id="admin_guide_000119__a22bc09b01b904bdd8ced3e03b2d09cd7">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="admin_guide_000119__row216212014451"><td class="cellrowborder" valign="top" width="32.32%" headers="mcps1.3.3.2.2.2.1.2.3.1.1 "><p id="admin_guide_000119__p5163172016454">Cluster</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="67.67999999999999%" headers="mcps1.3.3.2.2.2.1.2.3.1.2 "><p id="admin_guide_000119__p316315204456">Indicates the cluster to which the parent tenant belongs.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000119__r519be038c30d4d2f90f9cdb93c66888a"><td class="cellrowborder" valign="top" width="32.32%" headers="mcps1.3.3.2.2.2.1.2.3.1.1 "><p id="admin_guide_000119__a38bcfeab506f40dc8da0154b885bef24">Parent Tenant Resource</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="67.67999999999999%" headers="mcps1.3.3.2.2.2.1.2.3.1.2 "><p id="admin_guide_000119__ad129e3dc7b454c2788a1653a30e62f55">Indicates the name of the parent tenant.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000119__rd5d932f9adb14a158f5eec8ea0751c7d"><td class="cellrowborder" valign="top" width="32.32%" headers="mcps1.3.3.2.2.2.1.2.3.1.1 "><p id="admin_guide_000119__afed3deccc0b6461397529f5b2fe65b74">Name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="67.67999999999999%" headers="mcps1.3.3.2.2.2.1.2.3.1.2 "><ul id="admin_guide_000119__u9b6671a8f9504ac5a895e4b1e84beae9"><li id="admin_guide_000119__lbbb74b8f56b54647bac714d081471299">Indicates the name of the current tenant. The value consists of 3 to 50 characters, including digits, letters, and underscores (_).</li><li id="admin_guide_000119__lf7f85faf361d4bfa816a7d6abd2bc44e">Plan a sub-tenant name based on service requirements. The name cannot be the same as that of a role, HDFS directory, or Yarn queue that exists in the current cluster.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000119__rf78a481101ad4fb38c4eae6239bd5fe4"><td class="cellrowborder" valign="top" width="32.32%" headers="mcps1.3.3.2.2.2.1.2.3.1.1 "><p id="admin_guide_000119__aeb7db1b3983b498b82c906c7f32dc2bf">Tenant Type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="67.67999999999999%" headers="mcps1.3.3.2.2.2.1.2.3.1.2 "><p id="admin_guide_000119__ae49e9a55df764b928096d45bf3c4b0f4">Specifies whether the tenant is a leaf tenant.</p>
|
|
<ul id="admin_guide_000119__ub8694a210adf4c69af67032bdc746619"><li id="admin_guide_000119__le9ee78a24daf4f36abd1a480b17d13bd">When <strong id="admin_guide_000119__b18323138133820">Leaf Tenant</strong> is selected, the current tenant is a leaf tenant and no sub-tenant can be added.</li><li id="admin_guide_000119__l0cfb2524d78a49fea4541d47cb614960">When <strong id="admin_guide_000119__b11257256123813">Non-leaf Tenant</strong> is selected, the current tenant is not a leaf tenant and sub-tenants can be added to the current tenant. However, the tenant depth cannot exceed 5 levels.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000119__r991583f250d349d38af0c41d32428a64"><td class="cellrowborder" valign="top" width="32.32%" headers="mcps1.3.3.2.2.2.1.2.3.1.1 "><p id="admin_guide_000119__aa79dc6015ee24fe08da2b2cca2575aa6">Computing Resource</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="67.67999999999999%" headers="mcps1.3.3.2.2.2.1.2.3.1.2 "><p id="admin_guide_000119__afed87f63f3c24300b01f7846f8f6075e">Specifies the dynamic computing resources for the current tenant.</p>
|
|
<ul id="admin_guide_000119__udc38ca6c2b4845539ad5c26f256bc022"><li id="admin_guide_000119__l7b8f4e0c5bcb4a23ad552054a9910814">When <strong id="admin_guide_000119__b1816511366397">Yarn</strong> is selected, the system automatically creates a queue in Yarn and the queue is named the same as the sub-tenant name.<ul id="admin_guide_000119__u2c393d0920d34b798cd3a4579f610180"><li id="admin_guide_000119__ldc683c8ad4474d3fb9db0c8fadba5d5b">A leaf tenant can directly submit jobs to the queue.</li><li id="admin_guide_000119__lef841d7518ec47029dae82cd946d7de5">A non-leaf tenant cannot directly submit jobs to the queue. However, Yarn adds an extra queue (hidden) named <strong id="admin_guide_000119__b13576140144018">default</strong> for the non-leaf tenant to record the remaining resource capacity of the tenant. Actual jobs do not run in this queue.</li></ul>
|
|
</li><li id="admin_guide_000119__l52fd29cece0a44a2b555ab03225ee19c">If <strong id="admin_guide_000119__b14130161717403">Yarn</strong> is not selected, the system does not automatically create a queue.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000119__r9b0e5e4dd0514f8c883ed68bb9868adc"><td class="cellrowborder" valign="top" width="32.32%" headers="mcps1.3.3.2.2.2.1.2.3.1.1 "><p id="admin_guide_000119__a31bf42f236654738b35a946d7cdfdba3">Default Resource Pool Capacity (%)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="67.67999999999999%" headers="mcps1.3.3.2.2.2.1.2.3.1.2 "><p id="admin_guide_000119__a5e9a6d01f51d40e497ab9c39328618a0">Indicates the percentage of computing resources used by the current tenant. The base value is the total resources of the parent tenant.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000119__r1e55e9cbf3a842b2bb3f39f7a9e95982"><td class="cellrowborder" valign="top" width="32.32%" headers="mcps1.3.3.2.2.2.1.2.3.1.1 "><p id="admin_guide_000119__a69e92b20a65a4a40957abc397f5a3b9b">Default Resource Pool Max Capacity (%)</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="67.67999999999999%" headers="mcps1.3.3.2.2.2.1.2.3.1.2 "><p id="admin_guide_000119__aaefab22e8cb44c1d942caad480daf4b0">Indicates the maximum percentage of computing resources used by the current tenant. The base value is the total resources of the parent tenant.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000119__re0fd5880d6264bbfb05bbab701fb4597"><td class="cellrowborder" valign="top" width="32.32%" headers="mcps1.3.3.2.2.2.1.2.3.1.1 "><p id="admin_guide_000119__a6a1d3d754c004cb2904d5dfa46c127dc">Storage Resource</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="67.67999999999999%" headers="mcps1.3.3.2.2.2.1.2.3.1.2 "><p id="admin_guide_000119__af781110a1c224df6b1f1c5e73db66961">Specifies storage resources for the current tenant.</p>
|
|
<ul id="admin_guide_000119__ud769817c5c394d89b8ef0811d03a3bd5"><li id="admin_guide_000119__l1eb0415b303540198ec7841176e98f47">When <strong id="admin_guide_000119__b94701229144313">HDFS</strong> is selected, the system automatically creates a folder named after the sub-tenant in the HDFS parent tenant directory.</li><li id="admin_guide_000119__l0e253521a1b143cb8cce5b85a9fe3136">When <strong id="admin_guide_000119__b6213113220439">HDFS</strong> is not selected, the system does not automatically allocate storage resources.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000119__row53465316583"><td class="cellrowborder" valign="top" width="32.32%" headers="mcps1.3.3.2.2.2.1.2.3.1.1 "><p id="admin_guide_000119__p5664155610578">Quota</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="67.67999999999999%" headers="mcps1.3.3.2.2.2.1.2.3.1.2 "><p id="admin_guide_000119__p12664145645717">Indicates the quota for files and directories.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000119__r5de58b95fae24d74bfd515bdc7620212"><td class="cellrowborder" valign="top" width="32.32%" headers="mcps1.3.3.2.2.2.1.2.3.1.1 "><p id="admin_guide_000119__a19f3817722e1419ca6fd6e860b79d6f8">Space Quota</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="67.67999999999999%" headers="mcps1.3.3.2.2.2.1.2.3.1.2 "><p id="admin_guide_000119__a3a74a2bbfa59441191844a66d02b00ff">Indicates the quota for the HDFS storage space used by the current tenant.</p>
|
|
<ul id="admin_guide_000119__u836a66c4eded43cab6018b08caee7b42"><li id="admin_guide_000119__l2e928c88e1de4477bf6cbaa9566c3b38">If the unit is set to <strong id="admin_guide_000119__b73710479436">MB</strong>, the value ranges from <strong id="admin_guide_000119__b17372174764311">1</strong> to <strong id="admin_guide_000119__b8372144774310">8796093022208</strong>. If the unit is set to <strong id="admin_guide_000119__b9372194764311">GB</strong>, the value ranges from <strong id="admin_guide_000119__b1337264704314">1</strong> to <strong id="admin_guide_000119__b337314477436">8589934592</strong>.</li><li id="admin_guide_000119__l94db7d4da77f4803a4d66bcfbbc572fe">This parameter indicates the maximum HDFS storage space that can be used by the tenant, but not the actual space used.</li><li id="admin_guide_000119__ld2808dbb1b1140b59c71e0b54551e06f">If its value is greater than the size of the HDFS physical disk, the maximum space available is the full space of the HDFS physical disk.</li><li id="admin_guide_000119__l8c1642c1090044e0a14c9e76bea1f9b7">If this quota is greater than the quota of the parent tenant, the actual storage space does not exceed the quota of the parent tenant.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000119__r9491ed2654914b23be8b681619fff452"><td class="cellrowborder" valign="top" width="32.32%" headers="mcps1.3.3.2.2.2.1.2.3.1.1 "><p id="admin_guide_000119__a66aa95bc53604a01a1e8465b6262d179">Storage Path</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="67.67999999999999%" headers="mcps1.3.3.2.2.2.1.2.3.1.2 "><p id="admin_guide_000119__ab5b8d13b70be4a21b6ff630c9cdb0014">Indicates the HDFS storage directory for the tenant.</p>
|
|
<ul id="admin_guide_000119__u2011b2b586dc4e258554bf90dd36f56f"><li id="admin_guide_000119__lc0804c83c2794af48da2567bedb5db45">The system automatically creates a folder named after the sub-tenant name in the directory of the parent tenant by default. For example, if the sub-tenant is <strong id="admin_guide_000119__b1469917944412">ta1s</strong> and the parent directory is <strong id="admin_guide_000119__b57004974411">/tenant/ta1</strong>, the storage path for the sub-tenant is then <strong id="admin_guide_000119__b670089154413">/tenant/ta1/ta1s</strong>.</li><li id="admin_guide_000119__l13a6004ad84e4f7baf16cf8b1817631b">The storage path is customizable in the parent directory.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000119__row829132421520"><td class="cellrowborder" valign="top" width="32.32%" headers="mcps1.3.3.2.2.2.1.2.3.1.1 "><p id="admin_guide_000119__p729162461512">Description</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="67.67999999999999%" headers="mcps1.3.3.2.2.2.1.2.3.1.2 "><p id="admin_guide_000119__p2290244152">Indicates the description of the current tenant.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<div class="note" id="admin_guide_000119__n81849778ba8543c7920c70d1713c3e20"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="admin_guide_000119__a45404d42fa9e4a32821831f44db9fe83">Roles, computing resources, and storage resources are automatically created when tenants are created.</p>
|
|
<ul id="admin_guide_000119__u632a7ec8552c48518a86cc6bf0fc2694"><li id="admin_guide_000119__l6f93c0d7842c4f258af0db943dcbe712">The new role has permissions on the computing and storage resources. This role and its permissions are automatically controlled by the system and cannot be manually managed by choosing <strong id="admin_guide_000119__b7431122220446">System</strong> > <strong id="admin_guide_000119__b1043220228447">Permission</strong> > <strong id="admin_guide_000119__b24321522154411">Role</strong>. The role name is in the format of <em id="admin_guide_000119__i94321522124412">Tenant name</em>_<em id="admin_guide_000119__i12432102212449">Cluster ID</em>. The ID of the first cluster is not displayed by default.</li><li id="admin_guide_000119__lf309f1ea459447f5ac0f0f3eb87717f5">When using this tenant, create a system user and bind the user to the role of the tenant. For details, see <a href="admin_guide_000120.html">Adding a User and Binding the User to a Tenant Role</a>.</li><li id="admin_guide_000119__l81ded30d6b0d45c190d7a2f61bcae85b">The sub-tenant can further allocate the resources of its parent tenant. The sum of the resource percentages of direct sub-tenants under a parent tenant at each level cannot exceed 100%. The sum of the computing resource percentages of all level-1 tenants cannot exceed 100%.</li></ul>
|
|
</div></div>
|
|
</p></li><li id="admin_guide_000119__li03551039125617"><span>Check whether the current tenant needs to be associated with resources of other services.</span><p><ul id="admin_guide_000119__ul879919203583"><li id="admin_guide_000119__li2799162018585">If yes, go to <a href="#admin_guide_000119__lcdfcd36b99d84c3ba2f290f976ade15b">4</a>.</li><li id="admin_guide_000119__li167996208582">If no, go to <a href="#admin_guide_000119__l93b6a287f2a9444f9b34fcbcc1e595ac">5</a>.</li></ul>
|
|
</p></li><li id="admin_guide_000119__lcdfcd36b99d84c3ba2f290f976ade15b"><a name="admin_guide_000119__lcdfcd36b99d84c3ba2f290f976ade15b"></a><a name="lcdfcd36b99d84c3ba2f290f976ade15b"></a><span>Click <strong id="admin_guide_000119__b6117927164411">Associate Service</strong> to configure other service resources used by the current tenant.</span><p><ol type="a" id="admin_guide_000119__en-us_topic_0165590104_ol1354662215317"><li id="admin_guide_000119__en-us_topic_0165590104_li5546142212317">Set <strong id="admin_guide_000119__b16101834194410">Services</strong> to <strong id="admin_guide_000119__b86101234114420">HBase</strong>.</li><li id="admin_guide_000119__en-us_topic_0165590104_li954672211316">Set <strong id="admin_guide_000119__b620718368449">Association Type</strong> as follows:<ul id="admin_guide_000119__en-us_topic_0165590104_ul1695017578405"><li id="admin_guide_000119__en-us_topic_0165590104_li3950457194015"><strong id="admin_guide_000119__b7948183720440">Exclusive</strong> indicates that the service resources are used by the tenant exclusively and cannot be associated with other tenants.</li><li id="admin_guide_000119__en-us_topic_0165590104_li8950145711400"><strong id="admin_guide_000119__b1335504084419">Shared</strong> indicates that the service resources can be shared with other tenants.</li></ul>
|
|
</li></ol>
|
|
<div class="note" id="admin_guide_000119__en-us_topic_0165590104_n189fb6f08a3e4ea683dbf702310d3b03"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="admin_guide_000119__en-us_topic_0165590104_u8b678ba5e65a42f19e469aa347793e2b"><li id="admin_guide_000119__en-us_topic_0165590104_ld90cf9f33ae34f51afc8ec74ffb813ed">Only HBase can be associated with a new tenant. However, HDFS, HBase, and Yarn can be associated with existing tenants.</li><li id="admin_guide_000119__en-us_topic_0165590104_l5b1dc74b41c54e7caa903b17cca2293c">To associate an existing tenant with service resources, click the target tenant in the tenant list, switch to the <strong id="admin_guide_000119__b2420134144517">Service Associations</strong> page, and click <strong id="admin_guide_000119__b1242717414515">Associate Service</strong> to configure resources to be associated with the tenant.</li><li id="admin_guide_000119__en-us_topic_0165590104_l0ebdfba5c19d4edc8eeaa270da57df75">To disassociate an existing tenant from service resources, click the target tenant in the tenant list, switch to the <strong id="admin_guide_000119__b10904174893414">Service Associations</strong> page, and click <strong id="admin_guide_000119__b1591874863420">Delete</strong> in the <strong id="admin_guide_000119__b2920448153415">Operation</strong> column. In the displayed dialog box, select <strong id="admin_guide_000119__b1692113483341">I have read the information and understand the impact</strong> and click <strong id="admin_guide_000119__b1992214818348">OK</strong>.</li></ul>
|
|
</div></div>
|
|
<ol type="a" start="3" id="admin_guide_000119__en-us_topic_0165590104_ol185461622163112"><li id="admin_guide_000119__en-us_topic_0165590104_li10546822133119">Click <strong id="admin_guide_000119__b938311567454">OK</strong>.</li></ol>
|
|
</p></li><li id="admin_guide_000119__l93b6a287f2a9444f9b34fcbcc1e595ac"><a name="admin_guide_000119__l93b6a287f2a9444f9b34fcbcc1e595ac"></a><a name="l93b6a287f2a9444f9b34fcbcc1e595ac"></a><span>Click <strong id="admin_guide_000119__b49071458174514">OK</strong>. Wait until the system displays a message indicating that the tenant is successfully created.</span></li></ol>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="admin_guide_000117.html">Creating Tenants</a></div>
|
|
</div>
|
|
</div>
|
|
|