Updated on 2024-09-23 GMT+08:00

Managing the MRS Tenant Resource Directory

You can manage the HDFS storage directory used by a specific tenant on MRS. The management operations include adding a tenant directory, modifying the directory file quota, modifying the storage space, and deleting a directory.

Prerequisites

  • The IAM users have been synchronized in advance. You can do this by clicking Synchronize next to IAM User Sync on the Dashboard page of the cluster details.
  • You have logged in to MRS Manager. For how to log in, see Accessing MRS Manager.
  • A tenant associated with HDFS storage resources has been added.

Managing a Tenant Directory

  1. Go to the Tenant page.

    • On the MRS management console: Click the target cluster. On the cluster details page, click Tenant.
    • On the Manager of an MRS 3.x or later cluster: Click Tenant Resources.
    • On the Manager of an MRS 2.x or later cluster: Click Tenant.

  2. In the tenant list on the left, click the target tenant.
  3. Click the resource tab and perform the following operations to manage tenant directory:

    • View the tenant directory.

      View related information in the HDFS Storage pane.

      • The File Number Threshold column provides the quota for files and directories of the tenant directory. (On the MRS management console, this parameter is Maximum Number of Files/Directories.)
      • The Storage Space Quota column indicates storage space size of tenant directories.
    • Add a tenant directory.
      1. In the HDFS Storage pane, click Create Directory.
        • Parent Directory: Select a storage directory of a parent tenant.

          This parameter is not displayed if the current tenant is not a sub-tenant. If the parent tenant has multiple directories, select any of them.

        • Path: Enter the tenant directory.
          • If the current tenant is not a sub-tenant, the new path is created in the HDFS root directory.
          • If the current tenant is a sub-tenant, the new path is created in the specified directory.

          A complete HDFS storage directory can contain a maximum of 1,023 characters. An HDFS directory name contains digits, letters, spaces, and underscores (_). The name cannot start or end with a space.

        • Maximum Number of Files/Directories: Enter the quota of files and directories. This parameter is optional.
        • File Number Threshold (%) is valid only when Quota is set. If the ratio of the number of used files to the value of Quota exceeds the value of this parameter, an alarm is generated. If this parameter is not specified, no alarm is reported in this scenario. This parameter is available for clusters of MRS 3.x or later.

          The number of used files is collected every hour. Therefore, the alarm indicating that the ratio of used files exceeds the threshold is delayed.

        • Storage Space Quota: Specify the storage space size of the tenant directory.

          To ensure data reliability, one copy of a file is automatically generated when the file is stored in HDFS. That is, two copies of the same file are stored by default. The HDFS storage space indicates the total disk space occupied by all these copies. For example, if the value of Storage Space Quota is set to 500, the actual space for storing files is about 250 MB (500/2 = 250).

        • Storage Space Threshold (%): If the ratio of used storage space to the value of Space Quota exceeds this value, an alarm is generated. If this parameter is not specified, no alarm will be reported in this scenario. This parameter is available for clusters of MRS 3.x or later.

          The used storage space is collected every hour. Therefore, the alarm indicating that the ratio of used storage space exceeds the threshold is delayed.

      2. Click OK. The system creates tenant directories in the HDFS root directory.
    • Modify a tenant directory.
      1. In the HDFS Storage table, click Modify in the Operation column of the specified tenant directory.
      2. Change the parameter values based on service requirements.
      3. Click OK.
    • Delete a tenant directory.
      1. In the HDFS Storage table, click Delete in the Operation column of the specified tenant directory.

        The default HDFS storage directory set during tenant creation cannot be deleted. Only the newly added HDFS storage directory can be deleted.

      2. Click OK. The tenant directory is deleted.