How to delete MTree on Data Domain systems

           

   Article Number:     535462                                   Article Version: 3     Article Type:    How To 
   

 


Product:

 

Data Domain Encryption

 

Instructions:

 

 

When you want to delete an MTree on Data Domain system, you can do it either from CLI or from System Manager. The user role required to perform this operation is Admin.    
   
    Deleting an MTree from CLI:   
   
    - List the MTrees present on the Data Domain using command "mtree list"   
    Example:   
    sysadmin# sysadmin@dd670# mtree list     
      Name                                    Pre-Comp (GiB)   Status   Tenant-Unit     
      -------------------------------------   --------------   ------   -----------     
      /data/col1/backup                                  0.0   RW       -     
      /data/col1/Default                                 0.0   RW       -     
      /data/col1/test                                    0.0   RW       -     
      -------------------------------------   --------------   ------   -----------     
       D    : Deleted     
       Q    : Quota Defined     
       RO   : Read Only     
       RW   : Read Write     
       RD   : Replication Destination     
       RLGE : Retention-Lock Governance Enabled     
       RLGD : Retention-Lock Governance Disabled     
       RLCE : Retention-Lock Compliance Enabled     
      sysadmin@dd670#
   
   
    - Delete the MTree using the command "mtree delete mtree_path"   
    Example:    
    sysadmin# mtree delete /data/col1/test     
     
      Deleting an MTree will destroy all data in the MTree.     
      If there are any NFS exports, CIFS shares, VTL tapes, DDBOOST storage-units, Replication Contexts or Physical Capacity Measurements configured for this MTree, they need to be manually removed/edited. Do you wish to continue?     
              Are you sure? (yes|no) [no]: yes     
     
      ok, proceeding.     
     
      MTree "/data/col1/test" deleted successfully.     
      sysadmin#
   
   
    Deleting an MTree from Data Domain system manager:   
   
    - Navigate through Data Management > MTrees.    
    - Select the MTree you want to delete   
    - Click on the 'Delete' Option   
   
    User-added image   
   
   
    Note: When trying to delete a certain MTree on Data Domain, you may get below error:   
   
    **** MTree "/data/col1/stu_test" contains ddboost storage unit, cannot be deleted.   
   
    Above error means that you are trying to delete an MTree that is associated with a ddboost storage-unit. In case of the above error, you need to delete the corresponding ddboost storage-unit which will change the MTree state to deleted (D).    
   
    Deleting storage-unit from CLI:   
   
    - List ddboost storage-units using the command "ddboost storage-unit show"   
    Example:   
    sysadmin# ddboost storage-unit show     
      Name                         Pre-Comp (GiB)   Status   User            Report Physical   Tenant-Unit     
                                                                                Size (MiB)     
      --------------------------   --------------   ------   -------------   ---------------   -----------     
      networker                               0.0   RW       ddboostmagdy2                 -   -     
      stu_test                                0.0   RW       ddboostmagdy2                 -   -     
      --------------------------   --------------   ------   -------------   ---------------   -----------     
       D    : Deleted     
       Q    : Quota Defined     
       RO   : Read Only     
       RW   : Read Write     
       RD   : Replication Destination
   
   
    - Delete the storage-unit using the command "ddboost storage-unit delete storage-unit_name"    
    Example:   
    sysadmin# ddboost storage-unit delete stu_test     
     
      The 'ddboost storage-unit delete' command will delete all files in the storage-unit.     
              Are you sure? (yes|no) [no]: yes     
     
      ok, proceeding.     
     
      Storage-unit "stu_test" deleted.     
      sysadmin# mtree list     
      Name                                    Pre-Comp (GiB)   Status   Tenant-Unit     
      -------------------------------------   --------------   ------   -----------     
      /data/col1/backup                                  0.0   RW       -     
      /data/col1/Default                                 0.0   RW       -     
      /data/col1/networker                               0.0   RW       -     
      /data/col1/stu_test                                0.0   D        -     
      -------------------------------------   --------------   ------   -----------
   
   
    Deleting store-unit from Data Domain system manager:   
   
    - Navigate through Protocols > DD Boost > STORAGE UNITS   
    - Select the storage-unit that you want to delete   
    - Click on Delete (Trash icon)   
   
    User-added image    
   
   
    Delete a specified storage unit, its contents, and any DD Boost associations. The deleted storage-unit retains its old name and is shown as deleted in the MTree list.    
    Note: You must also manually remove (expire) corresponding catalog entries from the backup application.   
   
    MTrees marked for deletion remain in the file system until the filesys clean command is run.   
     
                                                                                                                           

 

 

Notes:

 

 

The 'mtree delete' command option is not allowed on Retention Lock Governance or Retention Lock Compliance MTrees unless they are empty.   
    You can revert the marked-for-deletion state of that MTree by running the mtree undelete command.   
    When an MTree is removed from the file system, snapshots associated with that MTree are also deleted from the /data/col1/mtree-name/.snapshot/ directory.