:original_name: mrs_01_0306.html

.. _mrs_01_0306:

Creating a Sub-tenant
=====================

Scenario
--------

You can create a sub-tenant on MRS if the resources of the current tenant need to be further allocated.

Prerequisites
-------------

-  A parent tenant has been added.
-  A tenant name has been planned. The name must not be the same as that of a role or Yarn queue that exists in the current cluster.
-  If a sub-tenant requires storage resources, a storage directory has been planned based on service requirements, and the planned directory does not exist under the storage directory of the parent tenant.
-  The resources that can be allocated to the current tenant have been planned and the sum of the resource percentages of direct sub-tenants under the parent tenant at every level does not exceed 100%.
-  You have synchronized IAM users. (On the **Dashboard** page, click **Synchronize** on the right side of **IAM User Sync** to synchronize IAM users.)

Procedure
---------

#. On the MRS details page, click **Tenants**.

   .. note::

      For MRS 1.7.2 or earlier, see :ref:`Creating a Sub-tenant <mrs_01_0540>`. For MRS 3.x or later, see :ref:`Overview <admin_guide_000097>`.

#. In the tenant list on the left, move the cursor to the tenant node to which a sub-tenant is to be added. Click **Create sub-tenant**. On the displayed page, configure the sub-tenant attributes according to the following table:

   .. table:: **Table 1** Sub-tenant parameters

       
      | Parameter                               | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
       
      | Parent tenant                           | Specifies the name of the parent tenant.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
       
      | Name                                    | Specifies the name of the current tenant. The value consists of 3 to 20 characters, and can contain letters, digits, and underscores (_).                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
       
      | Tenant Type                             | The options include **Leaf** and **Non-leaf**. If **Leaf** is selected, the current tenant is a leaf tenant and no sub-tenant can be added. If **Non-leaf** is selected, sub-tenants can be added to the current tenant.                                                                                                                                                                                                                                                                                                                                                                                  |
       
      | Dynamic Resource                        | Specifies the dynamic computing resources for the current tenant. The system automatically creates a task queue named after the sub-tenant name in the Yarn parent queue. When dynamic resources are not **Yarn**, the system does not automatically create a task queue. If the parent tenant does not have dynamic resources, the sub-tenant cannot use dynamic resources.                                                                                                                                                                                                                              |
       
      | Default Resource Pool Capacity (%)      | Specifies the percentage of the resources used by the current tenant. The base value is the total resources of the parent tenant.                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
       
      | Default Resource Pool Max. Capacity (%) | Specifies the maximum percentage of the computing resources used by the current tenant. The base value is the total resources of the parent tenant.                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
       
      | Storage Resource                        | Specifies storage resources for the current tenant. The system automatically creates a file in the HDFS parent tenant directory. The file is named the same as the name of the sub-tenant. If storage resources are not **HDFS**, the system does not create a storage directory under the root directory of HDFS. If the parent tenant does not have storage resources, the sub-tenant cannot use storage resources.                                                                                                                                                                                     |
       
      | Space Quota (MB)                        | Specifies the quota for HDFS storage space used by the current tenant. The minimum value is 1, and the maximum value is the total storage quota of the parent tenant. The unit is MB. This parameter indicates the maximum HDFS storage space that can be used by a tenant, but does not indicate the actual space used. If the value is greater than the size of the HDFS physical disk, the maximum space available is the full space of the HDFS physical disk. If the quota is greater than the quota of the parent tenant, the actual storage capacity is subject to the quota of the parent tenant. |
      |                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
      |                                         | .. note::                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
      |                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
      |                                         |    To ensure data reliability, one backup is automatically generated for each file saved in HDFS, that is, two copies are generated in total. The HDFS storage space indicates the total disk space occupied by all these copies. For example, if the value is set to **500**, the actual space for storing files is about 250 MB (500/2 = 250).                                                                                                                                                                                                                                                          |
       
      | Storage Path                            | Specifies the tenant's HDFS storage directory. The system automatically creates a file folder named after the sub-tenant name in the directory of the parent tenant by default. For example, if the sub-tenant is **ta1s** and the parent directory is **tenant/ta1**, the system sets this parameter for the sub-tenant to **tenant/ta1/ta1s**. The storage path is customizable in the parent directory. The parent directory for the storage path must be the storage directory of the parent tenant.                                                                                                  |
       
      | Service                                 | Specifies other service resources associated with the current tenant. HBase is supported. To configure this parameter, click **Associate Services**. In the dialog box that is displayed, set **Service** to **HBase**. If **Association Mode** is set to **Exclusive**, service resources are occupied exclusively. If **share** is selected, service resources are shared.                                                                                                                                                                                                                              |
       
      | Description                             | Specifies the description of the current tenant.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
       

#. Click **OK** to save the settings.

   It takes a few minutes to save the settings. If the **Tenant created successfully** is displayed in the upper-right corner, the tenant is added successfully. The tenant is created successfully.

   .. note::

      -  Roles, computing resources, and storage resources are automatically created when tenants are created.
      -  The new role has permissions on the computing and storage resources. The role and its permissions are controlled by the system automatically and cannot be controlled manually under **Manage Role**.
      -  When using this tenant, create a system user and assign the user a related tenant role. For details, see :ref:`Creating a User <mrs_01_0345>`.
