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

On FusionInsight Manager, click Tenant Resources.

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.
Configuration Mode	Indicates the configuration mode of computing resource parameters. If you select Basic, you only need to set Default Resource Pool Capacity (%). If you select Advanced, you can manually configure the resource allocation weight and the minimum, maximum, and reserved resources of a tenant.
Default Resource Pool Capacity (%)	Specifies the computing resource usage of the current tenant. The base value is the total resources of the parent tenant.
Weight	Resource allocation weight. The value ranges from 0 to 100.
Minimum Resource	Resources guaranteed for the tenant resource (preemption supported). The value can be a percentage of the parent tenant resource's resources or an absolute value. When a tenant resource has a light workload, the resources of the tenant resource are automatically allocated to other tenant resources. When the available resources of the tenant resource do not meet the minimum threshold, the tenant resource can preempt the resources lent to other tenant resources.
Maximum Resource	Maximum resources that a tenant resource can use. The value can be a percentage of the parent tenant resource's resources or an absolute value.
Reserved Resource	Resources reserved for a tenant resource. Even when a tenant resource has no workload, other tenant resources cannot use the reserved resources of the tenant resource. The value can be a percentage of the parent tenant resource's resources or an absolute value.
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.
Service	For details about whether to associate resources of other services, see 4.
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%.

Whether the current tenant need to associate resources of other services.
- If yes, go to 4.
- If no, go to 5.
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.
Click OK. When Tenant created successfully. is displayed on the page, the tenant is added successfully.