Help Center> MapReduce Service> User Guide (ME-Abu Dhabi Region)> FusionInsight Manager Operation Guide (Applicable to 3.x)> Tenant Resources> Using the Capacity Scheduler in Multi-Tenant Scenarios> Creating Tenants> Adding a Sub-Tenant
Updated on 2022-12-08 GMT+08:00
View PDF

Adding a Sub-Tenant

Scenario

Based on the resource consumption and isolation plan and requirements of services, you can create Sub-Tenants on FusionInsight Manager, and allocate resources of the current tenant to meet the actual application scenario.

Prerequisites

  • A parent tenant has been added, and belongs to a non-leaf tenant.
  • 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.
  • Resources to be allocated to the current tenant have been planned to ensure that the sum of capacities of direct sub-tenants at every level cannot exceed the current tenant.

Procedure

  1. On FusionInsight Manager, click Tenant Resources.
  2. In the tenant list on the left, move the cursor to the tenant node to which the sub-tenant is added. Click . In the displayed window, configure the sub-tenant properties based on Table 1.

    Table 1 Sub-tenant parameters

    Parameter

    Description

    Cluster

    Specifies the cluster of the parent tenant.

    Parent Tenant Resource

    Specifies the name of the parent tenant.

    Name
    • Specifies the name of the current tenant. The value consists of 3 to 50 characters, which can be letters, digits, or underscores (_).
    • 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.

    Tenant Type

    Specifies whether the specified tenant is a leaf tenant.

    • When Leaf Tenant is selected, the current tenant is a leaf tenant and no sub-tenant can be added.
    • When Non-leaf Tenant 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.

    Computing Resource

    Specifies the dynamic computing resources for the current tenant.

    • When Yarn is selected, the system automatically creates a task queue in Yarn and the queue is named the same as the name of the tenant.
      • A leaf tenant can directly submit tasks to the task queue.
      • A non-leaf tenant cannot directly submit tasks to the task queue. However, Yarn adds an extra task queue (hidden) named Default for the non-leaf tenant to record the remaining resource capacity of the tenant. Actual tasks do not run in this queue.
    • When dynamic resources are not Yarn resources, the system does not automatically create a task queue.

    Default Resource Pool Capacity (%)

    Specifies the computing resource usage of the current tenant. The base value is the total resources of the parent tenant.

    Default Resource Pool Max Capacity (%)

    Specifies the maximum computing resource usage of the current tenant. The base value is the total resources of the parent tenant.

    Storage Resource

    Specifies storage resources of the current tenant.

    • When HDFS is selected, 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.
    • When HDFS is not selected, the system does not automatically allocate storage resources.

    Quota

    Specifies the file and directory quantity quota.

    Space Quota

    Specifies the used HDFS storage space quota of the current tenant.

    • When Space Quota Unit is set to MB, this parameter ranges from 1 to 8796093022208. When Space Quota Unit is set to GB, this parameter ranges from 1 to 8589934592. The maximum value of this parameter does not exceed the total storage quota of the parent tenant.
    • This parameter indicates the maximum HDFS storage space that can be used by the tenant, but does not indicate the actual space used.
    • If the value is greater than the size of the HDFS physical disk space, the maximum space that can be used is all the HDFS physical disk space.
    • If this quota is greater than the quota of the parent tenant, the actual storage space will be affected by the quota of the parent tenant.

    Storage Path

    Specifies the HDFS storage directory for a tenant.

    • The system 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 the Storage Path for the sub-tenant to /tenant/ta1/ta1s.
    • The storage path is customizable in the parent directory.

    Description

    Configure the description of the current tenant.

    During the creation of a tenant, the system automatically creates a corresponding role, the computing resources, and the storage resources.

    • The new role has the rights on the computing resources and storage resources. The role and its rights are controlled by the system automatically and cannot be controlled manually under System > Permission > Role. The role name is tenant name_cluster ID. By default, the cluster ID of the first cluster is not displayed.
    • When using this tenant, create a system user and bind the user to the role of the tenant. For details, see Adding a User and Binding the User to a Tenant Role.
    • The sub-tenant can further allocate the resources of the current tenant. The sum of the resource percentage of direct sub-tenants of a parent tenant cannot exceed 100%. The sum of the computing resource percentage of all level-1 tenants cannot exceed 100%.

  3. Whether the current tenant need to associate resources of other services.

    • If yes, go to 4.
    • If no, go to 5.

  4. Click Associated Service to configure other service resources used by the current tenant.

    1. Select HBase in Service.
    2. Make a selection in Association Type:
      • Exclusive indicates service resources used by the tenant exclusively. Other tenants cannot associate with this service.
      • Share indicates shared service resources, which can be used by other tenants.
    • When creating a tenant, you can only associate HBase with the tenant. For existing tenants, you can associate the following services: HDFS, HBase, and Yarn.
    • Associating existing tenants with service resources: In the tenant list on the left of the Tenant Management page, click the target tenant. Then, switch to the Service Association tab page and click Associated Service to associate the current tenant with service services.
    • Canceling the association between existing tenants and service resources: In the tenant list on the left of the Tenant Management page, click the target tenant. Then, switch to the Service Association tab page, click Delete, select I have read the information and understand the impact., and click OK to cancel the association with service.
    1. Click OK.

  5. Click OK. When Tenant created successfully. is displayed on the page, the tenant is added successfully.
Parent topic: Creating Tenants